Skip to main content

MoSim Modding

Welcome to the MoSim Robot Modding Documentation. This documentation exists to help the community understand, create, and share custom robot mods for MoSim.

MoSim’s modding support is intentionally scoped and evolving. These docs are designed to be a living, community-driven resource, where contributors can document discoveries, best practices, limitations, and examples as robot modding matures.

What You Can Mod​

At this time, MoSim supports robot mods only.

Robot mods allow you to:

  • Add custom robots to MoSim
  • Configure drivetrains, mechanisms, and motion
  • Define robot physical properties and behavior within supported systems
  • Recreate real-world FRC robots or design original concepts

What Is Not Supported​

The following are not currently moddable in MoSim:

  • Fields
  • Game pieces
  • Game rules or scoring logic
  • Physics engines or global simulation behavior
  • UI / HUD elements
  • Audio, effects, or animations outside robot assets

If something is not documented here, it should be assumed unsupported unless explicitly stated otherwise.

Who These Docs Are For​

These docs are written for:

  • FRC students and mentors
  • Teams recreating their real robots
  • Community members experimenting with robot design

Experience levels may vary. Some sections are beginner-friendly, while others assume familiarity with CAD, simulation concepts, or configuration files.

Community-Driven Documentation​

This documentation is not exhaustive and is not expected to be.

Much of what’s documented here comes from:

  • Community experimentation
  • Reverse engineering supported behaviors
  • Shared best practices
  • Trial-and-error discoveries

If you learn something new while modding a robot, you are encouraged to contribute it so others don’t have to rediscover it.

Stability & Expectations​

Robot modding support may change over time. Features may be added, adjusted, or deprecated as MoSim evolves.

These docs aim to:

  • Reflect current behavior as accurately as possible
  • Clearly label limitations or experimental features
  • Avoid speculation unless explicitly marked as future plans

Getting Help​

If something doesn’t work:

  • Look for known limitations
  • Ask on the Discord with details about what you tried

Clear reports help improve both MoSim and these docs.

Disclaimer​

  • MoSim robot modding is provided as-is.
  • Not all real-world robot behaviors can be perfectly simulated, and realism may vary depending on configuration choices and performance constraints.
  • This introduction was generated by AI, but AI contributions to these docs will not be accepted