DDNet-insta based on DDRaceNetwork, a Teeworlds mod. See the website for more information.

For build instructions visit the ddnet repo.

Features

checkbox votes

If a vote is added starting with a [ ] in the display name. It will be used as a checkbox. If the underlying config is currently set that checkbox will be ticked and users see [x] in the vote menu. This feature is optional and if you do not put any [ ] in your config it will not be using any checkboxes. It is only applied for ddnet-insta settings not for all ddnet configs. It is recommended to set sv_vote_checkboxes 0 at the start of your autoexec and sv_vote_checkboxes 1 at the end so it does not update all votes for every setting it loads.

unstack chat for ddnet clients

Newer DDNet clients do not show duplicated messages multiple times. This is not always wanted when using call binds for team communication during pvp games. So there is sv_unstack_chat to revert that ddnet feature and ensure every message is sent properly in chat.

0.6 and 0.7 support including ready change

ddnet-insta uses the 0.6/0.7 server side version bridge from ddnet. So all gametypes are playable by latest teeworlds clients and ddnet clients at the same time.

In 0.7 there was a ready change added which allows users to pause the game. It only continues when everyone presses the ready bind. This feature is now also possible for 0.6 clients using the /pause chat command. This feature should be turned off on public servers sv_player_ready_mode 0 because it will be used by trolls.

gametype support

iCTF

sv_gametype iCTF

Instagib capture the flag. Is a team based mode where every player only has a laser rifle. It kills with one shot and capturing the enemy flag scores your team 100 points.

gCTF

sv_gametype gCTF

Grenade capture the flag. Is a team based mode where every player only has a rocket launcher. It kills with one shot and capturing the enemy flag scores your team 100 points.

Configs

• sv_gametype Game type (gctf, ictf)
• sv_spectator_votes Allow spectators to vote
• sv_countdown_unpause Number of seconds to freeze the game in a countdown before match continues after pause
• sv_countdown_round_start Number of seconds to freeze the game in a countdown before match starts (0 enables only for survival gamemodes, -1 disables)
• sv_scorelimit Score limit (0 disables)
• sv_timelimit Time limit in minutes (0 disables)
• sv_player_ready_mode When enabled, players can pause/unpause the game and start the game on warmup via their ready state
• sv_force_ready_all minutes after which a game will be force unpaused (0=off) related to sv_player_ready_mode
• sv_grenade_ammo_regen Activate or deactivate grenade ammo regeneration in general
• sv_grenade_ammo_regen_time Grenade ammo regeneration time in miliseconds
• sv_grenade_ammo_regen_num Maximum number of grenades if ammo regeneration on
• sv_grenade_ammo_regen_speed Give grenades back that push own player
• sv_grenade_ammo_regen_on_kill Refill nades on kill (0=off, 1=1, 2=all)
• sv_grenade_ammo_regen_reset_on_fire Reset regen time if shot is fired
• sv_sprayprotection Spray protection
• sv_only_hook_kills Only count kills when enemy is hooked
• sv_kill_hook Hook kills
• sv_killingspree_kills How many kills are needed to be on a killing-spree (0=off)
• sv_damage_needed_for_kill Damage needed to kill
• sv_allow_zoom allow ddnet clients to use the client side zoom feature
• sv_anticamper Toggle to enable/disable Anticamper
• sv_anticamper_freeze If a player should freeze on camping (and how long) or die
• sv_anticamper_time How long to wait till the player dies/freezes
• sv_anticamper_range Distance how far away the player must move to escape anticamper
• sv_chat_ratelimit_long_messages Needs sv_spamprotection 0 (0=off, 1=only messages longer than 12 chars are limited)
• sv_chat_ratelimit_spectators Needs sv_spamprotection 0 (0=off, 1=specs have slow chat)
• sv_chat_ratelimit_public_chat Needs sv_spamprotection 0 (0=off, 1=non team chat is slow)
• sv_chat_ratelimit_non_calls Needs sv_spamprotection 0 (0=off, 1=ratelimit all but call binds such as 'help')
• sv_chat_ratelimit_spam Needs sv_spamprotection 0 (0=off, 1=ratelimit chat detected as spam)
• sv_chat_ratelimit_debug Logs which of the ratelimits kicked in
• sv_fastcap Insert flag captures into ddrace rank database
• sv_vote_checkboxes Fill [ ] checkbox in vote name if the config is already set
• sv_hide_admins Only send admin status to other authed players
• sv_show_settings_motd Show insta game settings in motd on join
• sv_unstack_chat Revert ddnet clients duplicated chat message stacking
• sv_tournament Print messages saying tournament is running. No other effects.
• sv_tournament_chat 0=off, 1=Spectators can not public chat, 2=Nobody can public chat
• sv_tournament_chat_smart Turns sv_tournament_chat on on restart and off on round end (1=specs,2=all)
• sv_tournament_join_msgs Hide join/leave of spectators in chat !0.6 only for now! (0=off,1=hidden,2=shown for specs)
• sv_round_stats_format_discord 0=csv 1=psv 2=ascii table 3=markdown table 4=json
• sv_round_stats_format_http 0=csv 1=psv 2=ascii table 3=markdown table 4=json
• sv_round_stats_format_file 0=csv 1=psv 2=ascii table 3=markdown table 4=json
• sv_spawn_weapons possible values: grenade, laser
• sv_tournament_welcome_chat Chat message shown in chat on join when sv_tournament is 1
• sv_round_stats_discord_webhook If set will post score stats there on round end
• sv_round_stats_http_endpoint If set will post score stats there on round end
• sv_round_stats_output_file If set will write score stats there on round end

Rcon commmands

• hammer Gives a hammer to you
• gun Gives a gun to you
• unhammer Removes a hammer from you
• ungun Removes a gun from you
• godmode Removes damage
• force_ready Sets a player to ready (when the game is paused)
• shuffle_teams Shuffle the current teams
• swap_teams Swap the current teams
• swap_teams_random Swap the current teams or not (random chance)

Chat commands

Most ddnet slash chat commands were inherited and are still functional. But /pause and /spec got removed since it is conflicting with pausing games and usually not wanted for pvp games.

ddnet-insta then added a bunch of own slash chat commands and also bang (!) chat commands

• !ready !pause /pause /ready to pause the game. Needs sv_player_ready_mode 1 and 0.7 clients can also send the 0.7 ready change message
• !shuffle /shuffle call vote to shuffle teams
• !swap /swap call vote to swap teams
• !swap_random /swap_random call vote to swap teams to random sides
• !settings show current game settings in the message of the day. It will show if spray protection is on or off and similar game relevant settings.
• !1v1 !2v2 !v1 !v2 !1on1 ... call vote to change in game slots
• !restart ?(seconds) call vote to restart game with optional parameter of warmup seconds (default: 10)

Publish round stats

At the end of every round the stats about every players score can be published to discord (and other destinations).

The following configs determine which format the stats will be represented in.

• sv_round_stats_format_discord 0=csv 1=psv 2=ascii table 3=markdown table 4=json
• sv_round_stats_format_http 0=csv 1=psv 2=ascii table 3=markdown table 4=json
• sv_round_stats_format_file 0=csv 1=psv 2=ascii table 3=markdown table 4=json

And these configs determin where the stats will be sent to.

• sv_round_stats_discord_webhook Will do a discord webhook POST request to that url. The url has to look like this: https://discord.com/api/webhooks/1232962289217568799/8i_a89XXXXXXXXXXXXXXXXXXXXXXX If you don't know how to setup a discord webhook, don't worry its quite simple. You need to have admin access to a discord server and then you can follow this 1 minute youtube tutorial.
• sv_round_stats_http_endpoint It will do a http POST request to that url with the round stats as payload. You can set this to your custom api endpoint that collect stats. Example: https://api.zillyhuhn.com/insta/round_stats
• sv_round_stats_output_file NOT IMPLEMENTED YET It will write the round stats to a file located at that path. You could then read that file with another tool or expose it with an http server. Example value: stats.json

csv - comma separated values (format 0)

NOT IMPLEMENTED YET

psv - pipe separated values (format 1)

---> Server: unnamed server, Map: tmp/maps-07/ctf5_spikes, Gametype: gctf.
(Length: 0 min 17 sec, Scorelimit: 1, Timelimit: 0)

**Red Team:**                                       
Clan: **|*KoG*|**                                   
Id: 0 | Name: ChillerDragon | Score: 2 | Kills: 1 | Deaths: 0 | Ratio: 1.00
**Blue Team:**                                      
Clan: **|*KoG*|**                                   
Id: 1 | Name: ChillerDragon.* | Score: 0 | Kills: 0 | Deaths: 1 | Ratio: 0.00
---------------------                               
**Red: 1 | Blue 0**  

Here is how it would display when posted on discord:

ascii table (format 2)

NOT IMPLEMENTED YET

markdown (format 3)

NOT IMPLEMENTED YET

json - javascript object notation (format 4)

{
        "server": "unnamed server",
        "map": "tmp/maps-07/ctf5_spikes",
        "game_type": "gctf",
        "game_duration_seconds": 67,
        "score_limit": 200,
        "time_limit": 0,
        "score_red": 203,
        "score_blue": 0,
        "players": [
                {
                        "id": 0,
                        "team": "red",
                        "name": "ChillerDragon",
                        "score": 15,
                        "kills": 3,
                        "deaths": 1,
                        "ratio": 3,
                        "flag_grabs": 3,
                        "flag_captures": 2
                },
                {
                        "id": 1,
                        "team": "blue",
                        "name": "ChillerDragon.*",
                        "score": 0,
                        "kills": 0,
                        "deaths": 3,
                        "ratio": 0,
                        "flag_grabs": 0,
                        "flag_captures": 0
                }
        ]
}