演员

演员

用于控制玩家操作的API

基础库

在 Ko-fi 上支持
Modrinth 下载量

🎭 Actor (ActorMC)

是否曾想过通过代码控制一个 Minecraft 玩家——干净利落、流畅自然,并且兼容服务器?

Actor 是一个模组 API / 开发者库,让你能够像玩家真的在按键和点击鼠标🖱️⌨️那样驱动一个玩家
非常适合自动化、测试、TAS 工具,以及“把玩家当作程序”的创意。


👤 面向玩家

⚠️ 本模组本身不会做任何事情。

Actor 是其他模组的库依赖。
如果你只安装 Actor,你不会看到任何新物品、命令或玩法变化。

✅ 在以下情况安装 Actor:

  • 有其他模组需要它作为依赖
  • 你是使用它进行开发的开发者🧑‍💻

🧑‍💻 面向开发者

📚 文档 / 安装配置 / API 参考:
👉 https://docs.actormc.net/

在你期望的所有平台上均受支持:

  • 🧵 Fabric
  • 🪡 Quilt
  • 🔥 Forge
  • ⚡ NeoForge

🚀 用 Actor 可以构建什么

借助 Actor,你可以创建能够完成以下事情的模组/工具:

  • 🤖 行为像真实玩家的自动游玩系统
  • ⏱️ TAS / 确定性输入回放
  • 🧪 自动化测试机器人,用于机制、农场、红石、战斗等
  • 🧭 脚本化移动 + 旋转(非常适合精确任务)
  • 🧱 自动化方块交互(放置/使用/攻击),且不破坏游戏规则
  • 🎮 高级“宏”风格工具——但以代码化、结构化且一致的方式实现

如果某件事看起来是玩家能够做到的……Actor 可以帮助你以程序方式实现它 ✅


✨ 为什么选择 Actor?

🔥 原生感
由 Actor 驱动的玩家行为会像真实客户端一样。

🧠 简洁的 API
为开发者打造:易于使用、易于扩展、易于推理。

🌍 服务器兼容理念
Actor 遵循真实的玩法限制——不会出现奇怪的失步行为。

⏲️ 基于刻的控制
编写与游戏循环自然同步运行的逻辑。


❤️ 为会写代码的创造者打造

如果你的模组想法涉及*“如果玩家可以……”*
Actor 就是让它成真的基础。🎮⚙️