GTPS CloudLua API & Server Scripting Docs

Learn how to extend your GTPS Cloud server with Lua, custom events, and powerful structures.

Get Started

Browse Lua Structures

⚡

Quick Start

Learn how to set up your environment and write your first script in just a few minutes.

🧠

Lua API Structures

Explore the full structure of players, items, worlds, tiles, drops, and more.

🎉

Event Tutorial

Step-by-step guide to building a custom event with buttons, dialogs, and rewards.

🧩

IDs & Effects

Look up dialog commands, Playmod IDs, Punch IDs, and other reference tables.

What is GTPS Cloud?

GTPS Cloud is a hosted growtopia private server with an extensive scripting API in Lua to customize your own private server.
These docs cover both the Lua API and server structures you'll interact with.

Where to start

New to GTPS Cloud? → Start at Quick Start.
Looking for specific structures? → Open any page in Lua API Structures in the sidebar.
Need IDs or reference tables? → Check IDs & Information.
Want to see a full example? → Follow the Event Tutorial.