Default game systems
The engine is a base: it has no built-in game rules, so server creators build their own with scripts. This page lists what the engine still does on its own and what it leaves to you.
What the engine does on its own
Section titled “What the engine does on its own”| Part | What it does | Switch |
|---|---|---|
| Walking | Arrow keys move the player and play walk and idle. Swamp halves the speed; water plays swim, chairs sit, beds sleep. |
disabledefmovement() (back on with enabledefmovement()); freezeplayer(seconds) stops it for a while |
| Chat | The chat line (Tab key) and the bubbles over heads. | Feature bits, below |
| Map | The M key opens the map. | disablemap() |
| Player list | The list of players online. | Replace it with your own GUI |
| Signs | The level file’s signs show their text when the player reads them. | Do not put signs in the level |
| Online time | onlinetime counts the seconds the account was online and is saved. |
Read-only |
| Weapons | A weapon is a script. addweapon and removeweapon give and take it; the engine has no weapon list or key of its own. |
Do not give weapons |
| Shots | shoot() sends a projectile. What it hits and what happens then is up to your scripts. |
Do not call it |
enablefeatures(mask) replaces the whole set of features. The default is every feature (allfeatures).
| Bit | Feature |
|---|---|
0x1 |
Map (M key) |
0x2 |
Pause screen |
0x40 |
Chat line (Tab key) |
0x80 |
Chat bubbles over heads |
0x200 |
Nicknames under players |
0x8000 |
Console (F2 key) |
The other bits exist so older scripts compile; they do nothing.
A client script that sets player.chat changes the chat of its player for everyone in the level, not only on its own screen. It does not raise onPlayerChats.
What the engine leaves to you
Section titled “What the engine leaves to you”(decision, Ruan, 2026-11-15) None of these exist in the engine: hearts, hit points, rupees, gralats, bombs, arrows, AP, MP, kills, deaths, rating, the sword and shield rules, chests and items, bombs, explosions, horses as level objects, baddies, dropped items, the built-in HUD, the A, S, and D keys, the weapon selector, the observer mode, and player-versus-player rules. onPlayerKilled, onWasHit, hitplayer, hitnpc, putbomb, putexplosion, showstats, and the disable* switches for those parts are gone.
Build them in scripts: keep your numbers in player fields or flags, draw your own HUD with GUI controls, and react to keys with onKeyPressed. A character may still carry a horseimg and draw a mount, and the sword and shield images are only how the character looks.
Default files
Section titled “Default files”The server’s default folder holds the files a new server starts with. The server’s copy of a file always wins over the copy built into the client.
| Files | Folder | How to change them |
|---|---|---|
Player animations (idle, walk, grab, push, pull, carry, swim, sit, sleep, and others) |
ganis/ |
Replace the file, or call replaceani("walk", "mywalk") in a script |
Sounds (steps2.wav from walk.gani) |
sounds/ |
Replace the file, or remove the PLAYSOUND line from the animation |
| Heads, bodies, hats, swords, shields, tiles | heads/, bodies/, hats/, swords/, shields/, tiles/ |
Replace the files |
The grab weapon (A key raises onActionGrab on NPCs in front) |
weapons/grab.bsc |
Do not give it to players, or remove it |
Engine version 0.1.0. Built 2026-11-18.