explaingit

openysmdev/openysm

Analysis updated 2026-06-24

★ 85JavaAudience · developerComplexity · 3/5LicenseSetup · moderate

TLDR

Open-source Minecraft Forge mod that replaces the player character with customizable Bedrock-format models and animations via GeckoLib, built as an alternative to the Yes Steve Model mod.

Mindmap

mindmap
  root((OpenYSM))
    Inputs
      Bedrock model files
      Animation files
      Player textures
    Outputs
      Custom player model
      Animated character
      Forge jar
    Use Cases
      Custom player skins
      Modded server visuals
      Animated emotes
    Tech Stack
      Java
      Forge
      GeckoLib
      Gradle
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Add customizable player character models to a Minecraft Forge 2.6.5 server.

USE CASE 2

Import Bedrock Edition model and animation files for player avatars.

USE CASE 3

Build the mod from source with the Gradle wrapper and ship a fork to your community.

USE CASE 4

Pair with the SIMD-Acceleration C++ companion library for faster rendering.

What is it built with?

JavaForgeGeckoLibGradle

How does it compare?

openysmdev/openysmagarrharr/phonegap-sms-pluginpengmoubuaixuexi/tagent
Stars858190
LanguageJavaJavaJava
Last pushed—2015-10-11—
Maintenance—Dormant—
Setup difficultymoderateeasyhard
Complexity3/52/55/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Needs a Forge 2.6.5 build environment with Gradle, bundled Wine Fox model has CC BY-NC-SA terms separate from the MIT source.

Source code is MIT, default character model is CC0 public domain, while the Wine Fox model is CC BY-NC-SA 4.0 and limits commercial use.

In plain English

OpenYSM is a Minecraft mod that replaces the standard player character model with a customizable one. The README, written in Chinese, presents the project as an open-source alternative to Yes Steve Model, a mod commonly known as YSM that does a similar job. This version is built against YSM 2.6.5 Forge and is offered so that players have a fully open implementation they can modify and redistribute on their own terms. Under the hood the mod uses a library called GeckoLib to handle the animation system, and it loads model and animation files in the format used by Minecraft Bedrock Edition. The README explains that this format choice is what lets players bring in their own character models and animations rather than being stuck with the default look. There is also an optional companion library written in C++ for faster rendering, kept in a separate repository called SIMD-Acceleration under the same OpenYSMDev organization. To build the mod from source, the README has you clone the repository, change into the folder, and run the Gradle build wrapper. The resulting jar file lands in build/libs. Contributions are welcomed in the form of issues, documentation improvements, bug fixes, and new features. The source code itself is released under the MIT license, while the bundled character models follow their own terms: the default model is released into the public domain through CC0, and a model called Wine Fox uses CC BY-NC-SA 4.0, which limits it to non-commercial use, requires attribution, and asks that any derived work uses the same license.

Copy-paste prompts

Prompt 1
Set up a Forge dev environment for OpenYSM, clone the repo, run the Gradle wrapper, and find the built jar in build/libs.
Prompt 2
Walk me through importing a Bedrock-format model and animation pack into OpenYSM and using it as my player character.
Prompt 3
Explain how OpenYSM uses GeckoLib for animations and show where to plug in a custom animation file in the source.
Prompt 4
Build OpenYSM together with the SIMD-Acceleration C++ companion library and show how the two repositories connect.
Prompt 5
Fork OpenYSM to add a new player model and document the license terms for the bundled Wine Fox model.

Frequently asked questions

What is openysm?

Open-source Minecraft Forge mod that replaces the player character with customizable Bedrock-format models and animations via GeckoLib, built as an alternative to the Yes Steve Model mod.

What language is openysm written in?

Mainly Java. The stack also includes Java, Forge, GeckoLib.

What license does openysm use?

Source code is MIT, default character model is CC0 public domain, while the Wine Fox model is CC BY-NC-SA 4.0 and limits commercial use.

How hard is openysm to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is openysm for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.

Alternatives & similar repos