Dash Faction Enhanced Dedicated Server Config: Difference between revisions

From Red Faction Wiki
No edit summary
No edit summary
Line 73: Line 73:
  <nowiki>
  <nowiki>
$DF Item Replacement: "ITEM_NAME" "ITEM_NAME" </nowiki>
$DF Item Replacement: "ITEM_NAME" "ITEM_NAME" </nowiki>
===Player Spawn Weapon===
*Allows the server to spawn all players with a specific weapon. If not specified, players spawn with a [[12mm handgun]].
*Weapon names are from [[weapons.tbl]]. Optionally, you can also specify the amount of ammo players spawn with for that weapon. If not specified, players spawn with an amount of ammo equal to 3x the weapon's clip size (as specified in [[weapons.tbl]]).
<nowiki>
$DF Default Player Weapon: "WEAPON_NAME"
    +Initial Ammo: AMMO_COUNT </nowiki>





Revision as of 13:26, 20 September 2020

This page lists example server templates you can use and customize to your liking when hosting a Dash Faction dedicated server. You'll find config options for most common use cases, but if you're running into issues customizing your server to your liking, please join the Red Faction Community Discord and we'll help you out.


NOTE: All custom Dash Faction options ($DF options) need to be inserted in dedicated_server.txt after the $Map lines.

Available Custom Options

Full List of Options

This is a complete list of all new custom options available in Dash Faction dedicated servers is This list is accurate as of Dash Faction version 1.5.0.

  • Custom options must appear in the order provided below. You do not have to specify all (or any) custom options, but if you specify any of them, they must be in this order.
  • Options are indicated by a preceding $ and optional parameters are indicated with a preceding +. You can specify options without optional parameters, but if you wish to use any optional parameters, you must also include the corresponding option.
$DF Vote Kick: true|false
$DF Vote Level: true|false
$DF Vote Extend: true|false
$DF Vote Restart: true|false
$DF Vote Next: true|false
$DF Vote Previous: true|false
$DF Spawn Protection Duration: TIME_IN_MILLISECONDS
$DF Hitsounds: true|false
$DF Item Replacement: "ITEM_NAME" "ITEM_NAME"
$DF Default Player Weapon: "WEAPON_NAME"
$DF Require Client Mod: true|false
$DF Player Damage Modifier: MULTIPLIER
$DF Saving Enabled: true|false
$DF Force Player Character: "CHARACTER_NAME"
 

Voting

  • The following options can be used to allow players to vote to perform actions like changing the map or kicking a player. See voting in Dash Faction for instructions on how to cast votes as a player.
  • Each vote option has an optional time limit parameters available. If no time limit is specified for a specific vote type, the vote will last for 60 seconds.
$DF Vote Kick: true|false
    +Time Limit: TIME_IN_SECONDS 
  • If true, players can vote to kick a player from the game.
$DF Vote Level: true|false
    +Time Limit: TIME_IN_SECONDS 
  • If true, players can vote to change to a specific level (by .rfl filename).
$DF Vote Extend: true|false
    +Time Limit: TIME_IN_SECONDS 
  • If true, players can vote to extend the current round by 5 minutes.
$DF Vote Restart: true|false
    +Time Limit: TIME_IN_SECONDS 
  • If true, players can vote to restart the current map.
$DF Vote Next: true|false
    +Time Limit: TIME_IN_SECONDS 
  • If true, players can vote to immediately switch to the next map in the server's map rotation.
$DF Vote Previous: true|false
    +Time Limit: TIME_IN_SECONDS 
  • If true, players can vote to immediately switch to the previous map in the server's map rotation.

Spawn Protection

  • Allows the server to specify the length of time (in milliseconds) players are invulnerable after respawning. If not specified, defaults to 1500ms (1.5 seconds).
$DF Spawn Protection Duration: TIME_IN_MILLISECONDS 

Hitsounds

  • If used, players hear a sound when they deal damage to another player.
  • Has optional parameters to specify the sound players hear (ID from sounds.tbl) and the maximum number of sounds played per second. Keeping the rate limit low is ideal to avoid bandwidth concerns - if you're unsure of potential impact, it's probably best to leave the rate limit option alone.
$DF Hitsounds: true|false 
    +Sound ID: SOUND_ID
    +Rate Limit: PACKETS_PER_SECOND 

Item Replacement

  • Allows the server to replace items (pickups) with other items, or disable specific items entirely.
  • You can include as many item replacement lines as you wish, in any order.
  • Item names are from items.tbl. To disable an item, include a replacement line specifying the item to disable in the first field and nothing in the second field. For an example, reference Config Templates below.
$DF Item Replacement: "ITEM_NAME" "ITEM_NAME" 

Player Spawn Weapon

  • Allows the server to spawn all players with a specific weapon. If not specified, players spawn with a 12mm handgun.
  • Weapon names are from weapons.tbl. Optionally, you can also specify the amount of ammo players spawn with for that weapon. If not specified, players spawn with an amount of ammo equal to 3x the weapon's clip size (as specified in weapons.tbl).
$DF Default Player Weapon: "WEAPON_NAME"
    +Initial Ammo: AMMO_COUNT 


Config Templates

Enable Hitsounds

  • Turns on hitsounds, sets the sound to use to sound id 29 (a beep), and sets a hitsound rate limit of 10 packets per second to save bandwidth.
$DF Hitsounds: true
+Sound ID: 29
+Rate Limit: 10

Make Players Spawn with SMG

  • Makes players spawn with an SMG instead of a 12mm Pistol and (optionally) sets the reserve ammo for the spawn weapon to 128.
$DF Default Player Weapon: "Machine Pistol"
+Initial Ammo: 128

Run Mods Without Players Needing Them

  • While you could always use the -mod command line option to run RF servers with mods, Dash Faction gives you the option to do so without requiring players to be running the same mod to join your server.
    $DF Require Client Mod: false

Disable Super Powerups

  • This will remove the Damage Amplifier, Invulnerability, Super Health, and Super Armor pickups from maps on your server.
$DF Item Replacement: "Multi Super Health" ""
$DF Item Replacement: "Multi Super Armor" ""
$DF Item Replacement: "Multi Invulnerability" ""
$DF Item Replacement: "Multi Damage Amplifier" ""

Rail-Only (Instagib) Mode

  • This will remove all pickups, set the player spawn weapon to the Rail Driver, and give the player 1000 ammo for it.
$DF Item Replacement:  "Remote Charge" ""
$DF Item Replacement:  "Remote Charges" ""
$DF Item Replacement:  "Riot Stick" ""
$DF Item Replacement:  "Handgun" ""
$DF Item Replacement:  "Silenced 12mm Handgun" ""
$DF Item Replacement:  "Shotgun" ""
$DF Item Replacement:  "Sniper Rifle" ""
$DF Item Replacement:  "rocket launcher" ""
$DF Item Replacement:  "Assault Rifle" ""
$DF Item Replacement:  "Machine Pistol" ""
$DF Item Replacement:  "grenades" ""
$DF Item Replacement:  "flamethrower" ""
$DF Item Replacement:  "riot shield" ""
$DF Item Replacement:  "rail gun" ""
$DF Item Replacement:  "heavy machine gun" ""
$DF Item Replacement:  "scope assault rifle" ""
$DF Item Replacement:  "shoulder cannon" ""
$DF Item Replacement:  "12mm_ammo" ""
$DF Item Replacement:  "5.56mm_ammo" ""
$DF Item Replacement:  "7.62mm_ammo" ""
$DF Item Replacement:  "explosive 5.56mm rounds" ""
$DF Item Replacement:  "10gauge_ammo" ""
$DF Item Replacement:  ".50cal_ammo" ""
$DF Item Replacement:  "Napalm" ""
$DF Item Replacement:  "rocket_launcher_ammo" ""
$DF Item Replacement:  "railgun_bolts" ""
$DF Item Replacement:  "riot_stick_battery" ""
$DF Item Replacement:  "Suit Repair" ""
$DF Item Replacement:  "Medical Kit" ""
$DF Item Replacement:  "First Aid Kit" ""
$DF Default Player Weapon: "rail_gun"
+Initial Ammo: 1000

Force All Players to Elite Guard Skin (Bald Guy)

  • This will force all multiplayer clients to the Elite Guard skin when they spawn in your server. This is effectively the same as the Pure Faction "Force Skin" option, though Dash Faction allows you to force whichever skin you want, rather than only the Elite Guard.
$DF Force Player Character: "elite"