Xarkanoth: Created page with "
{{Release_page_header|title=Ryan's Melee Drill System}}
{{Release_TOC|content=
On this page

Overview

Quick Start

Commands

Bot Subcommands

Configurables

Mod Config Variables

#example-config|..."

2026-07-10T22:34:29Z

Created page with "<div class="hf-relpage hf-mds-page"> {{Release_page_header|title=Ryan's Melee Drill System}} <div class="hf-relpage-body"> {{Release_TOC|content= <div class="hf-toc-category">On this page</div> <div>Overview</div> <div>Quick Start</div> <div>Commands</div> <div>Bot Subcommands</div> <div>Configurables</div> <div>Mod Config Variables</div> <div>#example-config|..."

New page

<div class="hf-relpage hf-mds-page">
{{Release_page_header|title=Ryan's Melee Drill System}}
<div class="hf-relpage-body">
{{Release_TOC|content=
<div class="hf-toc-category">On this page</div>
<div>[[#overview|Overview]]</div>
<div>[[#quick-start|Quick Start]]</div>
<div>[[#commands|Commands]]</div>
<div>[[#bot-subcommands|Bot Subcommands]]</div>
<div>[[#configurables|Configurables]]</div>
<div>[[#mod-config-variables|Mod Config Variables]]</div>
<div>[[#example-config|Example Config]]</div>
<div>[[#support|Support]]</div>
}}
<div class="hf-relpage-content">

<div class="hf-mds-hero">
<div class="hf-mds-kicker">Community Server Tool</div>
<div class="hf-mds-title">Run melee drills, arena fights, and bot lines from remote console commands.</div>
<div class="hf-mds-text">Melee Drill System (MDS) is a utility mod by RyanLT for Holdfast: Nations At War servers. It adds commands and config variables for controlled melee arenas, X-v-X drills, group fights, open melee practice, and repeatable bot spawning.</div>
</div>

<div class="hf-mds-facts">
<div class="hf-mds-fact"><span>Command Prefix</span>All runtime commands use the <code>rc</code> prefix and require admin login.</div>
<div class="hf-mds-fact"><span>Arena Required</span>Most drills use a rectangular arena defined by two corner points.</div>
<div class="hf-mds-fact"><span>Config Support</span>Use <code>mod_variable</code> or <code>mod_variable_local</code> to configure MDS in rotations.</div>
<div class="hf-mds-fact"><span>Source</span>[https://github.com/Ryannlt/RyansDrillScripts Ryan's Drill Scripts on GitHub]</div>
</div>

{{Release_section
|id=overview
|title=Overview
|content=
MDS tracks round and player state to run custom melee drills and utility commands. Server admins can use live <code>rc</code> commands during a session or add modded config variables to server rotation files for repeatable setups.

<div class="hf-mds-note">Commands are case-insensitive. Arguments in angle brackets are required, while arguments in square brackets are optional.</div>

<div class="hf-mds-label">Command Quick Reference</div>
<pre class="hf-code">rc set ArenaCorner1
rc set ArenaCorner2
rc 3v3
rc groupfight
rc openmelee 2 7
rc bot spawn 5 French ArmyLineInfantry
rc summonLine 10 French ArmyLineInfantry
rc spawnLine -20 30 90 10 French ArmyLineInfantry
rc get xvxDistance
rc set lineBotCount 10</pre>
}}

{{Release_section
|id=quick-start
|title=Quick Start
|content=
Set up an arena first, then run one of the drill commands.

<div class="hf-mds-step-grid">
<div class="hf-mds-step"><span>1. Set Arena Corners</span><pre class="hf-code">rc set ArenaCorner1
rc set ArenaCorner2</pre>Use your current position, or pass coordinates with <code>rc set ArenaCorner1 [x,z]</code> and <code>rc set ArenaCorner2 [x,z]</code>.</div>
<div class="hf-mds-step"><span>2. Run A Drill</span><pre class="hf-code">rc 3v3
rc groupfight
rc openmelee 2 7</pre>Start a structured X-v-X, a group fight, or random open melee spawns inside the arena.</div>
<div class="hf-mds-step"><span>3. Spawn Bots</span><pre class="hf-code">rc bot spawn 5 French ArmyLineInfantry
rc summonLine 5</pre>Add drill targets, lines, or replacement bots using the bot commands.</div>
</div>
}}

{{Release_section
|id=commands
|title=Commands
|content=
{{{!}} class="wikitable hf-mds-command-table"
! scope="col" style="width:22%;" class="code" {{!}} Command
! scope="col" style="width:32%;" {{!}} Usage
! scope="col" {{!}} Description
{{!}}-
{{!}} <code>xvx</code>
{{!}} <code>rc xvx <attacking:int> <defending:int> [strategy] [distance:float] [spacing:float] [orientation]</code>
{{!}} Spawns an X-v-X match inside the arena. Shorthand commands such as <code>rc 3v3</code> and <code>rc 20v1</code> are supported. Defaults use <code>xvxStrategy</code>, <code>xvxDistance</code>, and <code>xvxSpacing</code>.
{{!}}-
{{!}} <code>groupfight</code>
{{!}} <code>rc groupfight [strategy] [distance:float] [spacing:float] [orientation]</code>
{{!}} Spawns both teams in lines for a group fight inside the arena. Defaults use <code>groupfightStrategy</code>, <code>groupfightDistance</code>, and <code>groupfightSpacing</code>.
{{!}}-
{{!}} <code>openmelee</code>
{{!}} <code>rc openmelee [spacing:float] [offset:float]</code>
{{!}} Spawns players randomly around the arena for open melee practice. Defaults use <code>openMeleeSpacing</code> and <code>openMeleeOffset</code>.
{{!}}-
{{!}} <code>bot</code>
{{!}} <code>rc bot <subcommand> [args]</code>
{{!}} Central command for spawning, summoning, listing, configuring, and removing bots.
{{!}}-
{{!}} <code>summonLine</code>
{{!}} <code>rc summonLine [count] [faction] [class] [ai] [death] [name [regtag [uniformId]]]</code>
{{!}} Spawns a shoulder-to-shoulder line of bots centered on your position and facing your direction. Defaults can use the caller's faction and class.
{{!}}-
{{!}} <code>spawnLine</code>
{{!}} <code>rc spawnLine <x> <z> <rotation> [count] [faction] [class] [ai] [death] [name [regtag [uniformId]]]</code>
{{!}} Spawns a bot line at a specific world position and rotation. Faction can be a faction name or <code>attacking</code>/<code>defending</code>.
{{!}}-
{{!}} <code>get</code>
{{!}} <code>rc get <Configurable> [additional arguments]</code>
{{!}} Reads MDS configurables and mod data at runtime. Additional shortcuts include <code>Player <playerId></code>, <code>Players <faction></code>, and <code>Round</code>.
{{!}}-
{{!}} <code>set</code>
{{!}} <code>rc set <Configurable> <Value> [additional arguments]</code>
{{!}} Sets MDS configurables at runtime, such as <code>xvxDistance</code>, <code>lineBotCount</code>, and <code>lineSpacing</code>.
{{!}}}

<div class="hf-mds-label">Examples</div>
<pre class="hf-code">rc xvx 3 3 next 4 1 northsouth
rc groupfight random 25 2 180
rc openmelee 2 7
rc spawnLine -20 30 90 10 French ArmyLineInfantry
rc get Players all
rc set xvxDistance 5</pre>
}}

{{Release_section
|id=bot-subcommands
|title=Bot Subcommands
|content=
All bot subcommands are accessed through <code>rc bot <subcommand> [args]</code>.

{{{!}} class="wikitable hf-mds-command-table"
! scope="col" style="width:20%;" class="code" {{!}} Subcommand
! scope="col" style="width:38%;" {{!}} Usage
! scope="col" {{!}} Description
{{!}}-
{{!}} <code>spawn</code>
{{!}} <code>rc bot spawn [count] [faction class] [ai] [death] [name [regtag [uniformId]]]</code>
{{!}} Spawns one or more specific bots at random server spawn points. Faction and class default to the caller if omitted.
{{!}}-
{{!}} <code>spawnRandom</code>
{{!}} <code>rc bot spawnRandom [count]</code>
{{!}} Spawns one or more bots with fully random faction and class.
{{!}}-
{{!}} <code>summon</code>
{{!}} <code>rc bot summon [faction] [class] [ai] [death] [name [regtag [uniformId]]]</code>
{{!}} Spawns a single bot at your position and facing your direction.
{{!}}-
{{!}} <code>setBotAi</code>
{{!}} <code>rc bot setBotAi <target> <ai></code>
{{!}} Sets AI behavior for tracked bots. Targets include <code>all</code>, <code>attacking</code>, <code>defending</code>, a faction name, or a player ID.
{{!}}-
{{!}} <code>setBotDeathPolicy</code>
{{!}} <code>rc bot setBotDeathPolicy <target> <policy></code>
{{!}} Sets bot death handling. Policies are <code>None</code>, <code>Kick</code>, and <code>Replace</code>.
{{!}}-
{{!}} <code>remove</code>
{{!}} <code>rc bot remove <target></code>
{{!}} Kicks tracked bots immediately. Targets include <code>all</code>, <code>attacking</code>, <code>defending</code>, a faction name, or a player ID.
{{!}}-
{{!}} <code>list</code>
{{!}} <code>rc bot list</code>
{{!}} Prints tracked bots to private messages, including player ID, faction, class, AI type, death policy, and spawn status.
{{!}}}

<div class="hf-mds-label">Bot Examples</div>
<pre class="hf-code">rc bot spawn
rc bot spawn 5
rc bot spawn Attacking ArmyLineInfantry
rc bot spawn 3 French ArmyLineInfantry None Replace
rc bot summon French ArmyLineInfantry
rc bot setBotDeathPolicy all Kick
rc bot remove all
rc bot list</pre>
}}

{{Release_section
|id=configurables
|title=Configurables
|content=
Defaults in Ryan's README are tuned for Palisade Arena A1.

{{{!}} class="wikitable hf-mds-config-table"
! scope="col" style="width:24%;" {{!}} Configurable
! scope="col" style="width:24%;" {{!}} Arguments
! scope="col" style="width:16%;" {{!}} Default
! scope="col" {{!}} Purpose
{{!}}-
{{!}} <code>ArenaCorner1</code>
{{!}} <code>x z</code> floats, or none
{{!}} Not set
{{!}} First corner of the arena play area. If no coordinates are passed, the command uses the admin's position.
{{!}}-
{{!}} <code>ArenaCorner2</code>
{{!}} <code>x z</code> floats, or none
{{!}} Not set
{{!}} Second corner of the arena play area. If no coordinates are passed, the command uses the admin's position.
{{!}}-
{{!}} <code>xvxDistance</code>
{{!}} Distance float
{{!}} <code>20</code>
{{!}} Distance between attacking and defending faction lines for <code>xvx</code>.
{{!}}-
{{!}} <code>xvxSpacing</code>
{{!}} Distance float
{{!}} <code>2</code>
{{!}} Space between each player on a line for <code>xvx</code>.
{{!}}-
{{!}} <code>xvxStrategy</code>
{{!}} <code>Random</code>, <code>Next</code>, <code>Any</code>, or <code>Repeat</code>
{{!}} <code>Random</code>
{{!}} Player selection strategy for <code>xvx</code>.
{{!}}-
{{!}} <code>groupfightDistance</code>
{{!}} Distance float
{{!}} <code>25</code>
{{!}} Distance between attacking and defending faction lines for <code>groupfight</code>.
{{!}}-
{{!}} <code>groupfightSpacing</code>
{{!}} Distance float
{{!}} <code>2</code>
{{!}} Space between each player on a line for <code>groupfight</code>.
{{!}}-
{{!}} <code>groupfightStrategy</code>
{{!}} <code>Random</code> or <code>Repeat</code>
{{!}} <code>Random</code>
{{!}} Player selection strategy for <code>groupfight</code>.
{{!}}-
{{!}} <code>openMeleeSpacing</code>
{{!}} Distance float
{{!}} <code>1.5</code>
{{!}} Minimum distance players can spawn from each other during <code>openmelee</code>.
{{!}}-
{{!}} <code>openMeleeOffset</code>
{{!}} Distance float
{{!}} <code>7</code>
{{!}} Minimum spawn distance from arena edges during <code>openmelee</code>.
{{!}}-
{{!}} <code>Orientation</code>
{{!}} Degree integer, or <code>NorthSouth</code>, <code>EastWest</code>, <code>SouthNorth</code>, <code>WestEast</code>, <code>Random</code>
{{!}} <code>90</code>
{{!}} Direction two lines spawn facing each other.
{{!}}-
{{!}} <code>botDefaultAi</code>
{{!}} <code>None</code>
{{!}} <code>None</code>
{{!}} Default AI behavior assigned to bots when not specified inline.
{{!}}-
{{!}} <code>botDefaultDeathPolicy</code>
{{!}} <code>None</code>, <code>Kick</code>, or <code>Replace</code>
{{!}} <code>Kick</code>
{{!}} Default death policy assigned to bots when not specified inline.
{{!}}-
{{!}} <code>botKickDelay</code>
{{!}} Seconds float
{{!}} <code>2</code>
{{!}} Delay after bot death before kicking, allowing the kill to register.
{{!}}-
{{!}} <code>botReplaceDelay</code>
{{!}} Seconds float
{{!}} <code>0.5</code>
{{!}} Delay after kicking a bot before re-spawning it.
{{!}}-
{{!}} <code>lineBotCount</code>
{{!}} Count integer greater than 0
{{!}} <code>10</code>
{{!}} Default number of bots used by <code>summonLine</code> and <code>spawnLine</code>.
{{!}}-
{{!}} <code>lineSpacing</code>
{{!}} Meters float greater than 0
{{!}} <code>0.55</code>
{{!}} Lateral spacing between bots in a line.
{{!}}}
}}

{{Release_section
|id=mod-config-variables
|title=Mod Config Variables
|content=
Use global <code>mod_variable</code> or per-map <code>mod_variable_local</code> entries to configure MDS through rotation configs.

<pre class="hf-code">mod_variable MDS:<ConfigVariable>:<Argument(s)>
mod_variable_local MDS:<ConfigVariable>:<Argument(s)></pre>

{{{!}} class="wikitable hf-mds-config-table"
! scope="col" style="width:26%;" {{!}} Area
! scope="col" style="width:28%;" {{!}} Variable
! scope="col" {{!}} Accepted Arguments
{{!}}-
{{!}} General
{{!}} <code>EnableDebugLogging</code><br /><code>EnableAdminOnly</code>
{{!}} <code>true</code> or <code>false</code>
{{!}}-
{{!}} Arena
{{!}} <code>SetArena</code><br /><code>AddArena</code><br /><code>SetArenaCorner1</code><br /><code>SetArenaCorner2</code>
{{!}} <code>(x,z),(x,z)</code> for arena pairs, or <code>x,z</code> for individual corners.
{{!}}-
{{!}} Drill
{{!}} <code>SetXvXDistance</code><br /><code>SetXvXSpacing</code><br /><code>SetXvXStrategy</code><br /><code>SetGroupfightDistance</code><br /><code>SetGroupfightSpacing</code><br /><code>SetGroupfightStrategy</code><br /><code>SetOpenMeleeSpacing</code><br /><code>SetOpenMeleeOffset</code><br /><code>SetOrientation</code>
{{!}} Distance floats, strategy options, or orientation values depending on the setting.
{{!}}-
{{!}} Bot
{{!}} <code>SetBotDefaultAi</code><br /><code>SetBotDefaultDeathPolicy</code><br /><code>SetBotKickDelay</code><br /><code>SetBotReplaceDelay</code>
{{!}} <code>None</code>, death policies, or delay values in seconds.
{{!}}-
{{!}} Line
{{!}} <code>SetLineBotCount</code><br /><code>SetLineSpacing</code><br /><code>SpawnLine</code>
{{!}} Count, spacing, or <code>x,z,rotation[,count][,faction][,class][,ai][,death][,name[,regtag[,uniformId]]]</code>.
{{!}}}

<div class="hf-mds-note"><code>MDS:SpawnLine</code> can be specified multiple times to schedule multiple bot lines when a round begins. <code>attacking</code> and <code>defending</code> resolve against the live round, so the same config can work across maps.</div>

<div class="hf-mds-label">SpawnLine Examples</div>
<pre class="hf-code">mod_variable_local MDS:SpawnLine:-20,30,90
mod_variable_local MDS:SpawnLine:-20,30,90,French
mod_variable_local MDS:SpawnLine:20,30,270,10,defending,ArmyLineInfantry,None,Replace,Bot,None,1</pre>
}}

{{Release_section
|id=example-config
|title=Example Config
|content=
<pre class="hf-code"># Global
mod_variable MDS:EnableDebugLogging:true
mod_variable MDS:EnableAdminOnly:true

# Map Rotation (per-map overrides)
mod_variable_local MDS:SetArena:(-40.99,42.69),(-3.35,5.38)
mod_variable_local MDS:SetXvXDistance:20
mod_variable_local MDS:SetXvXSpacing:2
mod_variable_local MDS:SetXvXStrategy:Random
mod_variable_local MDS:SetGroupfightDistance:25
mod_variable_local MDS:SetGroupfightSpacing:2
mod_variable_local MDS:SetGroupfightStrategy:Random
mod_variable_local MDS:SetOpenMeleeSpacing:1.5
mod_variable_local MDS:SetOpenMeleeOffset:7
mod_variable_local MDS:SetOrientation:NorthSouth

# Bots
mod_variable_local MDS:SetBotDefaultDeathPolicy:Replace
mod_variable_local MDS:SetBotKickDelay:2
mod_variable_local MDS:SetBotReplaceDelay:0.5
mod_variable_local MDS:SpawnLine:-20,30,90,10,attacking,ArmyLineInfantry
mod_variable_local MDS:SpawnLine:20,30,270,10,defending,ArmyLineInfantry,None,Replace,Bot,None,1</pre>
}}

{{Release_section
|id=support
|title=Support
|content=
For feedback, bug reports, and the latest upstream documentation, see [https://github.com/Ryannlt/RyansDrillScripts Ryan's Drill Scripts on GitHub].

Future features listed in the source README include automatic repeating drills, modded UI, multi-arena support, and expanded bot AI such as autostab, autoblock, and 1v1 bot behavior.
}}

</div>
</div>
</div>

Ryans Melee Drill System - Revision history

Xarkanoth: Created page with " {{Release_page_header|title=Ryan's Melee Drill System}} {{Release_TOC|content= On this page Overview Quick Start Commands Bot Subcommands Configurables Mod Config Variables #example-config|..."

Xarkanoth: Created page with "
{{Release_page_header|title=Ryan's Melee Drill System}}
{{Release_TOC|content=
On this page

Overview

Quick Start

Commands

Bot Subcommands

Configurables

Mod Config Variables

#example-config|..."