Permissions

This page lists every permission a plugin can name in its manifest’s permissions, what each one unlocks, and what other players can see when a plugin uses it.

How permissions work

A plugin asks for permissions in reskate-plugin.json:

{
    "api": 1,
    "entry": "plugin/main.lua",
    "permissions": ["events.tricks", "overlay", "storage"]
}

A function or event outside the plugin’s permissions raises a Lua error that names what it needs:

reskate.camera.look needs the "camera" permission in reskate-plugin.json
the draw event needs the "overlay" permission in reskate-plugin.json

The event error comes from reskate.on, when you register the handler, not when the event fires.

A name not on this page fails the manifest: unknown permission "<name>": check the spelling, or update ReSkate. Every permission ReSkate plans is on the list already, so a manifest written for a later ReSkate still loads here.

The base set: no permission

Every plugin has these without asking:

reskate.id, reskate.api_version, reskate.side, reskate.log, print and require (base)
reskate.on with the events load, unload, tick, level_loaded and level_unloading (events)
reskate.time.now, after, every and cancel (time); slow and speed need game.speed
reskate.level.current (base)
reskate.package.read, read_json and list: the plugin’s own files (package)
reskate.json.encode and decode (JSON)
reskate.expose, require_plugin, emit and on_plugin: functions and events between plugins (libraries)

Interface

Permission	Unlocks	What other players see
`console`	`reskate.console.command`, `reskate.console.print`	Nothing.
`overlay`	The `draw` event and its drawing object (`d:text`, `d:rect`, `d:line`, `d:circle`, `d:poly`, `d:gradient`, `d:world_text`, `d:world_line`, `d:world_circle`, `d:image`, `d:world_image`, `d:game_image`, `d:skeleton`, `d:size`, `d:world_to_screen`) (overlay); `reskate.ui.toast`; `reskate.skater.xray`	Nothing: it draws on your screen only.
`menu`	`reskate.menu.page`, `reskate.menu.panel` and their widgets (`ui:card`, `ui:tabs`, `ui:heading`, `ui:label`, `ui:note`, `ui:warn`, `ui:info`, `ui:separator`, `ui:bar`, `ui:button`, `ui:toggle`, `ui:slider`, `ui:dropdown`), on the plugin’s own page in the menu’s PLUGINS section	Nothing.
`ui.screen`	`reskate.ui.screen`, `reskate.ui.open`, `reskate.ui.close`; the `screen_closed` event	Nothing.
`input`	`reskate.input.bind`, `flight`, `gamepad`, `joystick`, `capture`, `hide`; the `action` event	Nothing. Your binds show on your Binds page.
`hud`	`reskate.hud.hide`, `reskate.hud.corner`	Nothing: it hides your HUD only.
`audio.ui`	`reskate.audio.play_ui`	Nothing.
`audio`	`reskate.audio.play`, `set`, `stop`, `playing`	Nothing: your game plays the sounds.

The skater

Permission	Unlocks	What other players see
`events.tricks`	The `trick_started`, `trick_landed` and `line_broken` events; `reskate.score.current`	Nothing.
`events.skater`	The `skater_state`, `bail`, `board_landed`, `body_hit`, `bail_end` and `grind_exit` events; `reskate.skater.state`	Nothing.
`events.physics`	The `physics_step` event (events)	Nothing.
`skater.read`	`reskate.skater.get`, `position`, `heading`, `speed`, `on_ground`; `reskate.board.motion`	Nothing.
`skater.teleport`	`reskate.skater.teleport`	Your skater where it lands, as with the console’s teleport. Refused in a session whose host turned teleporting off.
`skater.control`	`reskate.skater.noclip`, `boost`, `freeze`, `wipeout`, `grind_exit`	Your skater as it moves and bails, and the side it pops out of a grind to. Noclip and boosts follow the host’s rules.
`trainer`	`reskate.trainer.set_point`, `reskate.trainer.back`	Your skater going back to the point, as a teleport. Refused when the host turned teleporting off.
`skater.animation`	`reskate.animation.play`, `stop`, `playing`, `replace`, `record`, `recorded`, `forget`, `trick`	The clips your skater plays: other players see your body as your game draws it.
`outfit`	`reskate.outfit.set`, `clear`, `find`, `slots`, `status`	What your skater wears over the outfit (tattoos, moles, eyewear; never a paid store item).
`board`	`reskate.board.bones`, `set`, `hide`, `clear`, `park`, `toss`	Nothing of your board changes, only what your game draws of it. `park` hides those bones on every board you see, other players’ included.
`camera`	`reskate.camera.look`, `set`, `follow`, `release`, `held`, `get`	Nothing.

The world

Permission	Unlocks	What other players see
`world.raycast`	`reskate.world.raycast`	Nothing.
`world.objects`	`reskate.objects.catalog`, `list`, `place`, `move`, `remove`	The objects you place, as any park editor object, under the session’s object rules and its limit on your objects.
`world.environment`	`reskate.world.set_time`, `set_control`, `set_park`	Your game’s time of day, world controls and parks. In a session, only the host chooses the parks.
`world.ai`	`reskate.ai.spawn`, `clear`, `count`	Nothing: spawning is refused in a session, where the other players would never see the AI skaters.
`travel`	`reskate.travel.locations`, `levels`, `go`, `load`	In a session only the host can travel, and the host’s travel changes where everyone is.

Multiplayer

Permission	Unlocks	What other players see
`session.read`	`reskate.session.active`, `is_dedicated`, `players`, `me`, `host`; the `player_joined` and `player_left` events	Nothing.
`session.skaters`	`reskate.session.skaters`	Nothing.
`session.nametags`	`reskate.session.tag`	Nothing: the tags show beside nametags on your game.
`net.session`	`reskate.net.send`; the `message` event	The same plugin on other players’ games (or its server copy) gets your messages. The session says who sent them.
`voice.control`	`reskate.voice.set_volume`	Nothing: it sets how loud a player is to you.
`chat.read`	The `chat` event (chat)	Nothing.
`chat.send`	`reskate.chat.send`	Everyone in the session sees the line, as your chat.
`chat.local`	`reskate.chat.notice`	Nothing: the line shows in your chat only, under the plugin’s name with a Plugin tag.
`server`	`reskate.server.kick`, `say`, `tell`, `move`, in the plugin’s server copy only	Everyone: players kicked, chat lines under the plugin’s name, skaters moved.
`throwdowns`	`reskate.throwdowns.state`, `host`, `cancel`, `hosting`; the `throwdown` event	The players you choose see your drop and join it with the game’s own Join.

Game and files

Permission	Unlocks	What other players see
`storage`	`reskate.storage.get`, `set`, `add`, `keys`	Nothing: storage stays on your PC.
`net.http`	`reskate.http.request`, to the hosts in the manifest’s `domains`	Nothing in game. The web servers you name see requests from your PC, with the user agent `ReSkate-Plugin/<folder name>`.
`music`	`reskate.music.current`, `play`, `pause`, `next`, `previous`, `game`, `game_next`; the `track_changed` event	Nothing: it reads and controls your music.
`progression.read`	`reskate.progression.get`	Nothing. It only reads.
`settings.read`	`reskate.settings.game`, `reskate.settings.names`	Nothing. It only reads.
`mods.read`	`reskate.mods.installed`, `reskate.mods.list`	Nothing.
`game.speed`	`reskate.time.slow`, `reskate.time.speed`	Nothing: slow motion is refused in a multiplayer session.
`replay`	No function or event yet.	Nothing. The manifest accepts it, so a plugin written for a later ReSkate loads.

A permission says what a plugin may try, not that the game lets it. Many calls still answer false and a reason when the game refuses: the host turned something off, you are a guest in a session, or the call came too often. The API pages say which.

Shared budgets

Some functions under different permissions share one rate budget. They are easy to trip over together:

reskate.skater.noclip, boost and freeze, reskate.camera.follow, reskate.ai.spawn, reskate.animation.play, reskate.board.toss and reskate.outfit.set: 4 calls a second between them.
reskate.skater.teleport and reskate.trainer.back: 2 a second between them.
reskate.music.play, pause, next, previous and game_next: 2 a second between them.
reskate.chat.send and reskate.server.say share one clock: a chat.send must come 3 s after the last line of either, and a server.say 1 s after.

Limits lists every rate.

Get started

Core API

Interface

The skater and the world

Multiplayer

Game

Guides

How permissions work

The base set: no permission

Interface

The skater

The world

Multiplayer

Game and files

Shared budgets

​How permissions work

​The base set: no permission

​Interface

​The skater

​The world

​Multiplayer

​Game and files

​Shared budgets

How permissions work

The base set: no permission

Interface

The skater

The world

Multiplayer

Game and files

Shared budgets