Account System
Players can create a persistent account tied to their in-game identity. Account data is stored server-side and survives between sessions.
Username / Password
Register a unique username secured with a hashed password.
Session Token
Auto-generated on login, expires at a set time to keep sessions secure.
Discord Link
Optional Discord ID binding for cross-platform identity.
Address Binding
Player's network address is stored and associated with their record.
Rank System
Ranks grant permanent boosts to money and XP gain, plus quality-of-life and cosmetic perks. The two donor tiers are purchasable and build on top of the Master / MasterPro free-rank benefits.
VIP
Free
A step above regular players.
Whitelist
Free
Trusted players with boosted earnings.
Master
Free
For dedicated players who've proven themselves.
- Money x5
- XP x4
- 30 min AFK grace period
- 50 HP/Armor cap & faster regen
MasterPro
Free
Elite players with serious advantages.
- Money x10
- XP x5
- 60 min AFK grace period
- 120 HP/Armor cap & faster regen
- Faster weapons & sprinting
- Teleport to players or cursor
Donor
€10
Support the server and enjoy exclusive perks.
- All Master rank benefits
- House system access
- Extra 2.5B in-game money
Best Value
DonorPro
€20
The ultimate supporter rank with everything unlocked.
- All MasterPro rank benefits
- House system access
- Extra 5B in-game money
Weapon Upgrades
All weapon upgrades from the official docs are implemented. Each weapon has its own upgrade tree unlocked in-game.
Boost Damage Explode Ghost Infinite Jetpack
Explode Heart Invisible Lights Mine Super
Bounce Cluster Explode Fast Ghost Jetpack Poison Spread
Bounce Cluster Explode Fast Ghost Poison Pull Spread
Bounce Cluster Fast Ghost Poison Spread
Confuse Copy Dragger Dropper Explode Fast Freeze Jail Mine Plasma Spread Swap UnFreeze
Passive abilities and server-wide perks.
Ball Begin Armor Fly Infinite Ammo Infinite Jump Lovely Regeneration Self Damage Sprint Weapons Spawn
Specials also include: Armor/heart rounding mechanics and laser barriers — additional protective and map-control tools.
Advanced power-ups. High skill ceiling.
Armor Aura Concentration Drone Flamethrower Gravispark Half Damage Knife Light Gun Lightning Laser Light Saber Mini Gun Pet Portal Protect Aura Rocket Drone Scream Second Chance Shield Super F Laser Tee Manipulator Telekinesis Touchkill Tron Light Vamp Gun Warps
Pet System
Each player can own a pet with its own stats, upgrades, and appearance. Pets level up by skilling stats with Points or Skill Points, and can be equipped with weapon upgrades.
Stats
Strength, Vitality, Defense, Rapidity — leveled up by skilling with Points (alongside bones) or Skill Points.
Upgrades
Pet has its own Hook, Gun, Shotgun, Grenade, Laser, and Special upgrade trees.
Consumables
Book of Oblivion (reset), Fortune Cookies, Magical Metal — special pet items.
Name & Skin
Customize your pet's name and tee skin appearance.
Points & Skill Points
Skilling a pet stat can be paid for with two different currencies, each with its own trade-off.
Points
General-purpose currency. Spent on skilling a stat, renaming the pet, or setting a new skin. Skilling with a point also consumes a bone matching the stat being trained, and the attempt can fail — the higher the stat's current level, the greater the chance of failure.
Skill Points
Dedicated skilling currency. Used only to skill a stat — no bone is consumed and the attempt is always guaranteed to succeed, regardless of the stat's level.
Bones & Pet Shop
Bones are consumed alongside Points when skilling a stat — never when spending Skill Points. Each bone type corresponds directly to one of the four pet stats.
VIT
Vitality Bone
Increases the pet's maximum health pool.
STR
Strength Bone
Increases the pet's damage output.
DEF
Defense Bone
Reduces damage taken by the pet.
RAP
Rapidity Bone
Increases the pet's movement and attack speed.
Fusion
Owner and pet can be merged into a single, more powerful creature.
Pet Fusion is a purchasable ability. Once active, the pet's stats are combined with the owner's, giving the owner increased strength while fused.
Economy
The server has a full in-game economy with multiple sources of income and spending.
Money Bags
Drop in-game, collect to earn money. Tracked in player stats.
Super Bags
Rare variant of money bags with higher payouts. Separately tracked.
General Wallet
On-hand cash used for most in-game purchases and transactions.
Experience
Earned alongside money. Contributes to rank progression.
Club House
A special in-game location. While inside, players passively earn extra money and experience every second. Entry requires a ticket.
Bank Rob
Players can attempt to rob the bank. Success gives a bank rob time — earning extra money every second. Failure gives a bank arrest — the player is put behind bars for a set duration.
Bank
Players can deposit money into the bank to earn interest. The bank has multiple account types and cooldown-based operations.
Balance
Deposited amount stored in the bank, separate from wallet cash.
Interest
Accrues over time based on account type. Collected on next login or manually.
Account Type
Different tiers offer different interest rates and withdrawal limits.
PIN Protection
Bank account is secured with a personal PIN (not exposed via API).
Cooldowns
Last operation, last update, last collect, rob cooldown, and arrest cooldown are all tracked.
Transactions
Full ledger: transfer, deposit, withdraw, purchase — with fee, tax, and reason fields.
Houses & Areas
Players can own a house on the map. Houses provide a private space with built-in protections.
House ID
Unique identifier for the owned property on the map.
House Safe
Activating the safe makes the player immune to damage for up to 1 hour while inside.
Sleep Time
Tracks time the player has spent resting inside their house.
Mini-Games & Game Modes
Dedicated mini-games and alternate game modes are available alongside the main city.
Insta
Instant-kill mode. One shot, one kill.
GInsta
Grenade Insta variant — one grenade, one kill.
Basketball
Score goals using the ball mechanic. Team or FFA format.
Race
Speed-based map completion. First to finish wins.
Tennis
Ball-rally style game mode. Keep it in play.
Event System
Server events rotate dynamically. MasterPro players and Donors can spend in-game currency to queue the next event.
Event Types
Survival
Last player standing wins. Boosted variant increases the chance of a high-tier reward bundle.
King of the Hill
Hold the zone to score. Boosted variant increases the chance of a high-tier reward bundle.
Money ×2
All money pickups are doubled for the duration of the event.
Money ×3
All money pickups are tripled for the duration of the event.
Money ×4
All money pickups are quadrupled for the duration of the event.
Purchase Options
Buy Specific Event
Choose and queue a specific event (Survival, KoH, Money ×2/3/4).
Random Event
Queue a randomly selected event from the standard pool.
Random Boosted Event
Queue a random event in boosted form — money events can reach ×6 or ×7, and Survival/KoH have a chance to award a high-tier bundle.
Food System
Consuming food grants temporary stat bonuses that last until the player logs out.
All food buffs are session-scoped — they reset on logout.
STR
Strength
Increases melee and weapon damage output.
VIT
Vitality
Boosts maximum health pool.
DEF
Defense
Reduces incoming damage taken.
RAP
Rapidity
Increases movement and attack speed.
HP
Health Points
Directly restores current health on consumption.
ARM
Armor
Directly restores current armor on consumption.
Police & Punishment System
Staff members can issue structured punishments. All actions are logged in a criminal record linked to the player's account and IP address.
Punishment Types
Arrest
Issued by police. The player is put behind bars and must wait until the sentence expires before they can play freely again.
Mute
Prevents the player from sending chat messages.
Ban
Blocks the player from connecting. Can be permanent (no expiry) or timed.
Lock
Freezes the player in-game — they can still log in but cannot move or play until the lock is lifted.
Kick
Immediately disconnects the player from the server.
Warn
Issues a formal warning. Logged but no immediate action taken.
Punishment Reasons
Spam Fun Vote Insult Bully Unfair Trap Position Unfair Combo Bug Abuse Bot Usage Multiple Accounts Account Sharing Giveaway Accounts Clan Tag Faking Player Disrespecting Staff
Record Fields
Severity
Numeric severity level associated with the punishment.
Duration
Applied at a timestamp; expires at another (or never, for permanent punishments).
Applied By
Staff member ID who issued the punishment.
Revocation
Punishments can be revoked with a reason and timestamp by staff.
Scope
Defines what the punishment targets: ip (address-based), player (account-based), or both.
Active Flag
Whether the punishment is currently in effect.
The Website
JustPuppet has a companion web frontend that displays real-time server data, player stats, rankings, and achievements. All pages share a dark-blue design system.
Home
Landing page with server connection info and feature overview.
Rankings
Live leaderboard of all registered players sorted by rank and stats.
Achievements
Browse all in-game achievements and see who has unlocked them.
Player Profile
Per-player page showing stats, upgrades, pet, bank summary, and criminal record.
Live
Real-time view of every connected server — see who's online right now.
Docs
This page — full feature reference for the server.
Live System
The Live page shows real-time server state pushed from the game server. It uses a persistent WebSocket connection; in development it falls back to HTTP polling every 5 seconds.
WebSocket messages are typed — live.state, ranking.update, player.updated, and achievement.unlocked are all handled. Servers not heard from for 30 seconds are automatically removed from the view.
Per-server state
Server Name + IP/Port
Each server card shows its name, live player count, and a connect button (Teeworlds 0.7 or DDNet UDP format).
Active Event
Current event name, remaining time, and info string shown as a gold badge on the card.
Moneybags
Count of active moneybags on the server shown in the card header.
Supermoneybag
When active, shows its location and time remaining in a purple badge.
Flag Available
Shown when a CTF flag is up for grabs on the server.
Per-player row
Skin Avatar
Custom-colored tee skin rendered as a pixel art avatar. Shows a dead tee or ninja sprite when applicable.
Registered Highlight
Players with a linked account get a blue glow and blue-bordered avatar to distinguish them from guests.
HP & Armor Bars
Green health bar and blue armor bar, scaled to the player's max values.
Area Location
The named area the player is currently in (e.g. Slum, Harbor, Central Prison).
Status Icons
Inline icon row: crown, house (own/guest + lock), frozen, fusion, protected, in water, screaming, pet, active weapon.
Bounty
Gold-highlighted row with prize amount and countdown bar. Row background turns gold.
Mini-game Stats
When in a mini-game: shows mode name, K/D ratio, streak, and elapsed time. Race/Basket show time-only.
Prison Display
Players in Central Prison show a bar-pattern overlay on their avatar.
CTF Flag
Red or blue flag icon shown on players currently carrying a flag.
Discord Integration
Accounts can be linked to Discord for cross-platform notifications and logging. Several game events are bridged to Discord automatically.
Achievement Unlocks
Notified to Discord when a player earns a new achievement.
Race Records
New best times in race mode are posted to Discord.
Criminal Records
Punishments issued or revoked are logged to a Discord channel.
Real-time Chat
In-game chat is bridged to Discord — messages flow both ways.
House Assigning
House ownership assignments and transfers are reported via Discord.
Police Radio
Police radio broadcasts are relayed to a dedicated Discord channel for off-game coordination.
House System (Extended)
Houses have interactive features beyond ownership — players can lock their doors, use a safe, and control who enters.
Door System
House doors can be opened or closed by the owner. Closed doors block entry to other players.
House Safe
Activating the house safe protects the player from all damage for up to 1 hour. Expires when the timer runs out or the player leaves.
Sleep Resting
Sleeping inside a house accumulates rest time. When the player wakes up, they receive bonus experience and cash based on how long they slept.
House Upgrades
Houses can be upgraded across seven tiers, each granting a permanent passive bonus while the owner is inside.
1
Health & Armor
Increases the owner's maximum health and armor while inside the house.
2
Damage Reduction
Reduces all incoming damage taken by the owner while inside the house.
3
Damage Amplification
Boosts the owner's outgoing damage while inside the house.
4
Money Farming
Improves the money yield from farming activities performed inside the house.
5
Sleep Income
Increases the cash payout received when the owner wakes up after sleeping in the house.
6
Safe Time
Extends the maximum duration the house safe can protect the owner from damage.
7
Sleep Money
Further enlarges the cash payout earned from sleeping in the house.
Chat, Police Radio & Call Vote
The server has multiple in-game chat channels for different audiences, alongside a structured voting system.
Police Radio
A police-only in-game chat channel. Only officers can read and send messages — invisible to regular players. Broadcasts are also relayed to Discord.
Private Chat
Direct messages between two players, visible only to the sender and recipient.
Area Chat
Messages visible only to players currently in the same area. Used for local coordination.
Call Vote System
Player-level menu system. Each player uses votes to perform actions for themselves — such as buying shop items.
