S&box - Using a Custom Game (.sbproj) on Pterodactyl
We’ll use S&business (by doctor) as an example, but the same steps apply to any S&box project.
📁 Uploading Your Project
Your S&box project must be placed inside the /projects directory:
/home/container/projects
Option 1: Upload via File Manager (Small Projects)
If your project is under ~2GB:
-
Go to Files in Pterodactyl
-
Navigate to:
/home/container/projects -
Click Upload
-
Upload your project folder (or files)
Option 2: Upload via SFTP (Recommended for Large Projects)
If your project is over 2GB, you should upload it as a .zip file using SFTP.
-
Go to SFTP Access in your panel
-
Use the provided credentials in an SFTP client (e.g. FileZilla)
-
Upload your
.zipfile to:/home/container/projects -
Return to the Pterodactyl File Manager
-
Right-click the
.zipfile and click Extract
After extraction, your project structure should look like:
/home/container/projects/your-project-name/
your-project-name.sbproj
⚙️ Configuring Server Variables
Next, configure your server to use the custom project.
- Go to the Startup tab in Pterodactyl
- Locate the variable:
Local Project (.sbproj)
Set this to the relative path of your project file:
richman/richman.sbproj
⚠️ Important:
- This path is relative to
/home/container/projects- Do NOT include
/home/container/projectsin the path
🔁 How This Affects Other Variables
- Setting Local Project (.sbproj) will override the
Gamevariable - You can still use the Map variable if your project supports separate map loading
▶️ Starting Your Server
Once configured:
- Save changes in the Startup tab
- Start (or restart) your server
Your custom S&box game should now load automatically.
🧠 Tips & Notes
-
Ensure your
.sbprojfile exists and the path is correct -
Folder names are case-sensitive on Linux
-
If the server fails to start, double-check:
- File paths
- Extraction completed correctly
- Project structure
🚧 Coming Soon
We’re planning to add Git-based deployment support, allowing you to pull projects directly from repositories instead of uploading manually.