?
Host a server
Modrinth App
Sign in
ModsPluginsData PacksShadersResource PacksModpacksServers
Settings
CNPCmmdskin

CNPCmmdskin

Brings MMDSkin model support to CustomNPCs! Each NPC can independently import models, perform dances, and utilizes a robust scripting API for creators to directly trigger specific animations.

39
0
39
0

Compatibility

Minecraft: Java Edition

1.20.1

Platforms

Supported environments

Client and server

Tags

Creators

Details

Licensed ARR
Published last week

📌 CNPC MMDSkin Extension

[简体中文] | [English]

简体中文

💡 关于本 Mod / About

本 Mod 是 CustomNPCs (CNPC) 的高性能扩展，旨在将 MMDSkin 的模型与动作系统完美引入到自定义 NPC 实体中。

它允许每一个 NPC 独立配置、导入外部的 MMD 模型与动画。除了可以通过专属的 GUI 面板进行常驻动画配置外，更提供了强大的脚本方法（Script API），让你可以通过代码动态控制 NPC 的模型更换与动画播放（如执行特定的舞蹈或动作演出）。

⚠️ 局限性说明：

  • 暂不支持“舞台模式（Stage Mode）”。
  • 非脚本模式下，NPC 面板中可选的模型与动作数量，完全取决于玩家自己当前动作面板中已有的数量（通过脚本方法调用则不受此数量限制）。

💻 脚本方法 (Script API)

开发人员和地图制作者可以使用以下全新的脚本方法来动态控制 NPC 的 MMD 状态：

  • setMmdSkin(modelName, player) 为 NPC 绑定指定的 MMD 模型，并实时网络同步给指定的玩家。
  • setMmdSkinLocal(modelName) 仅在本地为 NPC 绑定 MMD 模型（不进行网络同步）。
  • playMmdAnimation(animName) 让 NPC 立即播放指定名称的 MMD 动画。
  • clearMmdSkin() 解除当前 NPC 的 MMD 模型绑定，将其恢复为默认的 Minecraft 渲染模式。
  • hasMmdSkin() 返回布尔值，检查当前 NPC 是否已经绑定了 MMD 模型。
  • getMmdSkinName() 获取当前 NPC 所绑定的 MMD 模型名称。

🎮 可视化功能与特性 (Features)

  • 独立面板配置： 默认情况下，玩家只需对着 NPC 按下 N 键即可打开专用面板，为该 NPC 单独挑选一个 MMDSKIN 模型。
  • 千人千面： 支持为不同的 NPC 穿戴和配置完全不同的 MMD 模型。
  • 常驻动作选择： 允许在面板中为 NPC 选择一段特定的动画并让其一直保持播放。
  • 运动动态触发： 优化了基础运动逻辑，NPC 默认走路时会直接触发并播放 MMDSkin 的跑步动画。
  • 支持外部导入： 与玩家系统一致，完全支持从外部导入你自定义的 MMD 模型与动作文件。

English

💡 About The Mod

This mod is a high-performance extension for CustomNPCs (CNPC) that brings the MMDSkin model and motion system to NPC entities.

It allows each individual NPC to load, configure, and import external MMD models and animations independently. Beyond standard GUI configurations, it features a robust Script API that empowers developers to dynamically swap models and trigger custom motion performances (like custom dances or cutscene actions) via code.

⚠️ Technical Limitations:

  • Stage Mode is currently NOT supported for NPCs.
  • In Non-Script Mode, the number of available models and animations in the NPC panel is directly linked to the amount available in the player's own motion panel (Scripted triggers are completely exempt from this limitation).

💻 Script API

Developers and map makers can utilize the following new methods to control NPC MMD states programmatically:

  • setMmdSkin(modelName, player) Binds a specified MMD model to the NPC and syncs it to the targeted player over the network.
  • setMmdSkinLocal(modelName) Binds the MMD model to the NPC locally only (no network synchronization).
  • playMmdAnimation(animName) Triggers the NPC to play a specific MMD animation by its name.
  • clearMmdSkin() Unbinds the MMD skin, restoring the NPC to its default Minecraft rendering.
  • hasMmdSkin() Returns a boolean checking whether the NPC currently has an active MMD model bound.
  • getMmdSkinName() Retrieves the name of the MMD model currently bound to the NPC.

🎮 Visual Features

  • Dedicated GUI Configuration: By default, players can aim at an NPC and press the N key to open a configuration panel to assign an MMDSKIN model.
  • Independent Models: Supports configuring entirely different MMD models for different NPCs simultaneously.
  • Persistent Animations: Allows you to select a specific animation from the GUI that the NPC will keep playing constantly.
  • Dynamic Movement Mapping: The movement logic is remapped so that when an NPC walks by default, it automatically triggers the running animation.
  • External Imports: Fully supports external loading of custom MMD models and motion assets, just like the player counterpart system.

展示模型借物表与使用守则 / Model Credits & Terms of Use

本模组发布与画廊展示中所使用的 MMD 模型均来源于社区公开配布。作为借用与展示的一方，我们在此对原作者及模型改造者的无私分享表示最衷心的感谢与崇高的敬意。

The MMD models used in this mod's release and gallery showcase are utilized from public community distributions. As the borrowing and showcasing party, we would like to express our most sincere gratitude and highest respect to the original creators and model modders for their selfless sharing.

  • 模型提供 / Model Provider： miHoYo (米哈游)
  • 模型改造 / Model Modifications： 观海 (Bilibili：观海子)
  • 最终解释权 / Final Interpretation Rights： miHoYo (米哈游)

⚠️ 借用守则与免责声明 / Usage Rules & Disclaimer：

  1. 严格禁止商用 / Non-Commercial Use Only： 本模组仅作为技术功能展示，所涉及的模型严禁用于任何商业盈利行为。 This mod extension is for technical demonstration only. Commercial usage is strictly prohibited.
  2. 禁止二次配布与拆解 / No Redistribution & Ripping： 请勿将展示中的模型进行二次上传分发，亦不得拆取部件用于改造其他模型。 Do not redistribute or re-upload these models, and do not rip parts from them to modify other models.
  3. 内容合规限制 / Content Restrictions： 严禁将包含此模型的作品或模组画面用于 R-18/18禁、极端宗教宣传、血腥恐怖猎奇以及人身攻击等违规内容。 Strictly prohibited from being used in R-18/NSFW works, extreme religious propaganda, gore, horror, or personal attacks.
  4. 责任澄清 / Disclaimer： 他人使用本模型所造成的一切不良后果，不由模型改造者与 miHoYo 承担，全部责任由实际使用者自行承担。 Neither the model modder nor miHoYo shall bear any responsibility for any negative consequences caused by others using this model. Full responsibility lies solely with the end-user.

📢 特别提示 / Special Notice：

本模组的画廊（Gallery）及封面图片仅作为 MMD 模型加载功能的实际效果展示。本模组（Mod）本身并不自带、也不内置这两个模型文件。

The gallery and cover images of this mod are strictly for demonstrating the actual rendering effects of the MMD skin loading feature. This mod itself DOES NOT include or come pre-packaged with these two model files.