AGENTS.md for AI coding assistants
Many people write game scripts with an AI coding assistant. An assistant that does not know Bornescript guesses: it writes JavaScript, calls functions that do not exist, and trusts what a client sends. AGENTS.md is one file that fixes that. It holds the rules of the language, the authoring conventions, the limits, the behaviors that may still change, and a list of every built-in function.
What is in the file
- What you are writing
- The language in one page
- Events and timers
- Authoring conventions
- Server and client
- Limits and the sandbox
- Provisional behaviors
- Common mistakes
- API digest
- How to check a script
- Older GS2 scripts
How to use it
Section titled “How to use it”- Download the file.
- Put it in the root of your script project, next to the
weapons,npcs, andclassesfolders. Most coding assistants read a file namedAGENTS.mdthere before they work. - Ask the assistant to write or change a script, and read what it writes before you upload it. Check a script with the editor of the RC tool, or in the playground when it needs no world.
About the file
Section titled “About the file”- It is generated from the same sources as this documentation: the language reference, the definitions of every built-in, and the list of open questions. It is updated with each engine version, so download it again after an update.
- It is written for a reader with no memory of the engine: short rules, no history.
- It is not a replacement for the language reference and the API reference. The file links to both.
Engine version 0.1.0. Built 2026-11-18.