Skip to content

unique-clan/ball

Repository files navigation

Player information

This mod introduces some new concepts for the ball mod, which are described below.

Shotgun
This is the ball. You can catch the ball. If you have a ball, you can't use any other weapon. The shotgun ammo reflects the time in seconds you can keep the ball before automatic shooting.
Ninja
This weapon is new for the ball mod. It replaces the old '/goalkeeper' chat command and provides a faster way to get a goalkeeper. On special maps, multiple goalkeepers are possible now.
Goalkeeper
The goalkeeper has multiple weapons, including the ninja mode. Hitting another player with the ninja will give you the ball. Goalkeeper do not have the jump limitation.
Health
By default the health is regenerating. Normal weapon hits will reduce your health. If your health reaches 0, you are stunned for some time.
Armor
On some maps you can pickup armor. Armor does not work against normal weapon attacks. Instead it reflects the bonus time to keep the ball for a longer time.
Hammer
As usual, you can get the ball from another player by using the hammer.
Other weapons
All other weapons make normal damage to tees and can stun them.

Server settings

Some settings are in number of ticks. 1 second = 50 Ticks.

To avoid a disappearing ball on client side, you should set the shotgun_lifetime appropriate:

 tune shotgun_lifetime 1000000
 tune shotgun_curvature 10
 tune shotgun_speed 700

Option Default Value Range Description
sv_ball_multi 0 0-1 With Multiball support enabled, the shotgun respawns regularly. Every player can keep a maximum of one ball. All other balls disappear.
sv_ball_goal_respawn 1 0-1 Respawn all players after scoring.
sv_ball_respawn 300 0-100000 Ball respawn time after scoring in ticks.
sv_ball_decay 10 0-100 Ball bounce speed decaying. With a high value, the ball slows down faster.
sv_health_regen 75 0-10000 Ticks between regenerating health.
sv_health_stunned 200 0-10000 Number of ticks you are stunned when health is down to 0
sv_ball_base_keep 150 0-1000000 Number of ticks you can keep the ball before automatic shooting.
sv_ball_armor_keep 25 0-1000000 Number of ticks that are added to the ball keep time per armor you have.
sv_ball_lifetime 90 0-1000000 Ball lifetime in seconds when no player touches the ball
sv_physical_start_vel 100 0-100
How much influence does the tee velocity have on the projectile velocity. 100 = physically correct. 0 = no influence (vanilla teeworlds).

Ball map development

The new entities are nearly equivalent to the new ones. You just have to change some things, like replacing the grenade-pickup through the shotgun and replace goalkeeper spawns. In the following I will describe all entities found in entities.png.

  • Kill players of red team.
  • Kill players of blue team.
  • Goal of red team.
  • Goal of blue team.
  • Border for goalkeeper of red team.
  • Border for goalkeeper of blue team.
  • Goal of red team which kills players. This is necessary to enable slam dunks.
  • Goal of blue team which kills players. This is necessary to enable slam dunks.
  • This tile is solid only for balls, so they bounce at this tile.
  • Exactly like the above tile, but additionally kills players.
  • Kills no goalkeeper but all other players
At the bottom of the entities, in the pickup area:
  • Shotgun = ball.
  • Right of laser rifle is the spawn for red and blue goalkeeper. Don't use the empty ninja spawn.