Guide

S&box - Using a Custom Game (.sbproj) on Pterodactyl
Step-By-Step

Learn how to upload and run a custom S&box game using a .sbproj file on Pterodactyl. This guide covers project uploads, SFTP for large files, and configuring server variables correctly.

Back to Guides

S&box - Using a Custom Game (.sbproj) on Pterodactyl

IGSteven IGSteven Staff Apr 18, 2026

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:

  1. Go to Files in Pterodactyl

  2. Navigate to:

    /home/container/projects
  3. Click Upload

  4. 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.

  1. Go to SFTP Access in your panel

  2. Use the provided credentials in an SFTP client (e.g. FileZilla)

  3. Upload your .zip file to:

    /home/container/projects
  4. Return to the Pterodactyl File Manager

  5. Right-click the .zip file 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.

  1. Go to the Startup tab in Pterodactyl
  2. 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/projects in the path

🔁 How This Affects Other Variables

  • Setting Local Project (.sbproj) will override the Game variable
  • You can still use the Map variable if your project supports separate map loading

▶️ Starting Your Server

Once configured:

  1. Save changes in the Startup tab
  2. Start (or restart) your server

Your custom S&box game should now load automatically.


🧠 Tips & Notes

  • Ensure your .sbproj file 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.

Share