# katton!

**katton** is the scripting system for adm1n abuse! you can use this to create custom items or custom events while you're the admin. you do this by writing `.kat` scripts in VSCode and by using the [VSCode extension](getting-started/setup.md) and exporting the code, and loading it into the server via **/katton import**

this wiki covers everything like the language, every built in event, every API you can call, examples, etc. this requires atleast a basic understanding of coding. if you do not understand or like scripting, try offering someone to code stuff for you! or just use AI..

**important!**: using scripts that purposefully causes **lag**, or the server to **crash**, or do something malicious like spam killing players every tick, or somehow finding a way to affect players that aren't suppose to be affected, could cause you to **temporarily** or in some cases **permanently** lose access to katton. create bug reports if you encounter any bugs, or make suggestions in the suggestion channel if you have anything you want added. we (the rlly high up staff) have the ability to temporarily or permanently remove access if we find you to be using it in a unintended/problematic way

### quick links

* new here? start with [setting up Katton](getting-started/setup.md)
* don't know what to do after setting up Katton? try [creating your first script](getting-started/first-script.md)
* looking for a specific function? check the [API reference](api/player.md) section in the sidebar
* want to see complete copy pasteable scripts? see the [examples](examples/leap-wand.md) section in the sidebar

### preview

```csharp
@Katton.command(name = "hello", permission = "admin") // whenever you run this command via /katton run hello, it will run the code
function sayHello(sender, args) {
    sender.sendMessage("&ahelo from katton!")
}

@Katton.listen("player_join") // only fires when someone joins the game (not the server)
function onJoin(event) {
    event.player.sendMessage("&ewelcome!")
}
```
