MTFPlus

A plugin that adds new subclasses to NTF Cadets. Requires EXILED

Usage

Place your classes in a .txt file (A MUST) into the MTFplus folder located at the AppData folder (windows), .config folder (Linux) or in a per-server basis (that is, in your server folder) if you're using the non-global config, if you're using the global one I'm actually unsure about where the files go, so check the console (probably .config/AppData).

Making a new class

Before anything else, Items and Roles are in the following link, they may be confusing without understanding what they are or where they come from: https://github.com/Grover-c13/Smod2/wiki/Enum-Lists

This is the template file. This one will be autogenerated first time you boot up the server, or if the MTFPlus folder is missing. Check the console, it will tell you where to put the files in

medic.txt

Inventory: KeycardSeniorGuard, GunProject90, Radio, Disarmer, Medkit, Medkit, Medkit, Medkit
Max: 2
Role: NtfCadet
Probability: 80
Ammo5: 200
Ammo7: 70
Ammo9: 50
HP: 110
Broadcast: You're a <b>Medic</b>. Remember to heal your teammates!

You don't need to have every single field written. Below is a table with every default value. If some class is missing Probability, for example, it will use a default of 100 (default values can't be edited, so make sure to change them if you don't like them). Check the wiki clicking here to know what I mean.

ItemManager Support, and how to use it

⚠️ EXILED doesn't currently have ItemManager. This won't work until someone does an ItemManager or something remotely close.

Below is how ItemManager will work assuming the item with name Shotgun is present in ItemManager Heavy-Shotgun.txt

Inventory: MTF_COMMANDER_KEYCARD, E11_STANDARD_RIFLE, IM:Shotgun, MICROHID, RADIO, DISARMER, MEDKIT, WEAPON_MANAGER_TABLET
[...]

In the event they use numerical ID's like old Minecraft did, it would be IM:XXX where XXX is the ID for the item.

For reference, more examples and ideas are provided in the wiki: https://github.com/RogerFK/MTFPlus/wiki. Feel free to add yours.

Configs

Config Option	Value Type	Default Value	Description
mtfp_enable	bool	true	Enables/disables this plugin completely
mtfp_debug	bool	false	Prints more info to the console and the MA logs
mtfp_aliases	string list	mtfp, mtfplus, m+	Aliases to use the commands to spawn people as certain subclasses, or to check the list/info for a specific class.
mtfp_ranks	rank list	owner, admin, e-girl	Who can spawn people (everyone can still check the list)
mtfp_user_console_list	int	2	If normals users should be able to see the list of MTFPlus classes with .mtfplist. Three modes: 0: Nobody 1: Everybody, but only the names 2: Names, inventories and probabilities (recommended so people stop asking about it)
mtfp_list_delay	float	0.3	The delay for the plugin to check the list of players who spawned (don't set it to 0, or else the plugin will probably not work in some scenarios)
mtfp_delay	float	0.1	Delay for the class to be set after the user's role is changed (this shouldn't be too high, neither too low)

Default values

Key	Default value	Definition
Inventory	default_item_cadet config from Smod2	The items the guy will respawn with. Used as in Smod2
Max	1	The maximum amount of players that can respawn as this class
Role	NTF_CADET	The role they will be after respawning. Yes, you can respawn a peanut "with 1 HP" as a Piñata.
Probability	100	Works as a percentage. This is NOT the chance of one player to spawn as the class, this is the chance for the class to be spawned (and the player is randomly picked). So if it's too low, it will probably not respawn.
HP	Role's default HP	Max HP you want them to have. More realistic, as they show the player if they actually have 100% and it doesn't go over the bar
Ammo5/Ammo7/Ammo9	Default ones that probably come from storm37k's Default Ammo plugin	Ammo5 is only used by the MTF E-11 Rifle. MP7 and Logicer use Ammo7. COM15, P90 and USP use Ammo9.
Broadcast	Empty	Tells the player a broadcast after respawning as that class

Commands

Use the aliases (MTFPlus, m+, mtfp, or whatever the owner/admins told you), then input the following arguments:

Command	Arguments	Description
RELOAD	None.	Reloads the list of MTF+ classes.
LIST	[ANYTHING]	Displays the subclasses name if LIST is typed alone, displays every subclass with their inventory if any other argument (1, true, full, complete...) is typed (example: m+ list ahfhahf)
DISPLAY	<subclass' name>	Display the complete info about a subclass based on its name
SPAWN	<player id/player's name> <subclass' name>	Spawns a player as a subclass. Useful for testing/events.