Skip to content

Commit 7ce8e31

Browse files
authored
Create README.md
1 parent 6237e85 commit 7ce8e31

1 file changed

Lines changed: 52 additions & 0 deletions

File tree

README.md

Lines changed: 52 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,52 @@
1+
# CuffConversion Plugin
2+
3+
CuffConversion is a lightweight and flexible Exiled plugin for SCP: Secret Laboratory. It allows players to switch teams upon escaping while cuffed, based on who cuffed them.
4+
5+
## Features
6+
7+
- Converts Chaos Insurgency players to MTF when escaping while cuffed by an MTF unit.
8+
- Converts MTF players to Chaos when escaping while cuffed by a Chaos Insurgency unit.
9+
- Fully configurable messages, timings, and conversion toggles.
10+
- Simple and clean implementation using Exiled's Player Events.
11+
12+
## Requirements
13+
14+
- SCP: Secret Laboratory (latest version) : 14.1.0
15+
- Exiled API v9.6.0 or newer
16+
- .NET Standard 2.0 support (for building)
17+
18+
## Installation
19+
20+
1. Download the compiled DLL and place it in your `plugins` folder.
21+
2. Start the server to generate the configuration file.
22+
3. Modify `CuffConversion.yml` in the `config` folder to fit your preferences.
23+
24+
## Configuration
25+
26+
Below is an example of the configuration file:
27+
28+
```yaml
29+
cuff_conversion:
30+
is_enabled: true
31+
convert_chaos_to_mtf: true
32+
convert_mtf_to_chaos: true
33+
broadcast_duration: 5
34+
chaos_to_mtf_message: "<color=green>You have been converted to MTF after escaping!</color>"
35+
mtf_to_chaos_message: "<color=red>You have been converted to Chaos after escaping!</color>"
36+
```
37+
| Option | Description |
38+
| ---------------------- | -------------------------------------------------------------- |
39+
| `is_enabled` | Enables or disables the entire plugin. |
40+
| `convert_chaos_to_mtf` | Converts Chaos players to MTF when cuffed by MTF and escape. |
41+
| `convert_mtf_to_chaos` | Converts MTF players to Chaos when cuffed by Chaos and escape. |
42+
| `broadcast_duration` | Duration in seconds for conversion messages to appear. |
43+
| `chaos_to_mtf_message` | Message shown when a Chaos player is converted to MTF. |
44+
| `mtf_to_chaos_message` | Message shown when an MTF player is converted to Chaos. |
45+
-------------------------------------------------------------------------------------------
46+
## Target Plugin:
47+
1. .Config / Exiled / Plugins / put dll file there
48+
2. SCPSL / Managed / Exiled / Plugin / put dll file
49+
3. The version for Labapi comme soon
50+
### ENJOY
51+
52+

0 commit comments

Comments
 (0)