S1MAPI - Schedule 1 Mapping API

S1MAPI is a mapping and construction library for Schedule 1 mods. Create procedural meshes, build structures, and load GLTF assets without asset bundles.

Documentation • GitHub Repository

---

What S1MAPI Does

• Procedural Meshes: Generate 3D shapes at runtime such as boxes, spheres, cylinders, and capsules
• Building Construction: Create buildings with walls, floors, roofs, windows, and furniture
• GLTF Loading: Import external 3D models without extra runtime dependencies
• Update Resilience: Avoid ScheduleOne types so mods survive game updates more cleanly

---

Installation

For Players

If a mod you want to use requires S1MAPI:

1. Download the S1MAPI package from Thunderstore
2. Extract the package - it includes UserLibs/S1MAPI_Mono.dll and UserLibs/S1MAPI_Il2Cpp.dll
3. Copy the correct DLL for your Steam branch into your game's UserLibs folder:
   • Regular Steam branch (default): Use S1MAPI_Il2Cpp.dll
   • Alternate Steam branch: Use S1MAPI_Mono.dll
4. Launch the game - S1MAPI will load automatically with MelonLoader

To check your Steam branch: Right-click Schedule 1 in Steam -> Properties -> Betas. If it shows "None" or no selection, you are on the regular branch and should use the Il2Cpp DLL.

For Developers

To use S1MAPI in your mod project:

1. Add the Mono S1MAPI DLL as a reference to your mod project
2. Build your mod against the Mono DLL - it works for both runtimes
3. Tell users to install S1MAPI separately with the correct DLL for their Steam branch

---

Building From Source

1. Clone the repository
2. Copy local.build.props.example to local.build.props
3. Edit local.build.props and set your game installation paths
4. Build with dotnet build S1MAPI.csproj -c Mono or dotnet build S1MAPI.csproj -c Il2cpp

---

Requirements

• Schedule 1
• MelonLoader 0.7.0+
• .NET Framework 4.7.2+ or .NET 6.0+

---

Learn More

• Getting Started
• Examples
• API Reference
• Contributing Guide

---

License

GNU GPL v3 License - see the LICENSE file.