Skip to content

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.

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.

(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.

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.