MineSentinel

MineSentinel is a workspace for connecting Minecraft servers with AstrBot and for producing AI-assisted server operation reports from persisted observation logs.

The workspace contains two runtime pieces:

Path	Purpose	License
AstrBotAdapter/	Minecraft plugin for Bukkit, Paper, Spigot, Folia, and Velocity	MIT License
astrbot_plugin_minecraft_adapter/	AstrBot plugin that connects to Minecraft servers, stores observations, and sends reports	GNU AGPL v3.0
/	Shared workspace metadata, CI, and integration notes	Apache License 2.0

The root LICENSE applies only to root-level workspace files. Subdirectories with their own LICENSE files keep their own licenses. See THIRD_PARTY_LICENSES.md for the full license map and dependency notes.

What It Does

• Bridges chat between Minecraft and AstrBot target sessions.
• Exposes server status, player list, and controlled remote command execution.
• Supports Bukkit/Paper/Spigot/Folia through one Backend jar and Velocity through a separate proxy jar.
• Collects MineSentinel observations from Minecraft without mutating server state, punishing players, or running RCON commands.
• Persists full observation windows as JSONL and builds 8-hour configurable AI summaries from disk, with full-window exports available for upload.
• Detects player-reported issues from dialogue with surrounding context, player names, backend/server scope, and metric context.

Artifacts

Java artifacts are thin jars. Runtime libraries are referenced externally instead of being shaded or relocated.

Artifact	Use
AstrbotAdaptor-*-Backend.jar	Bukkit/Paper/Spigot/Folia backend servers
AstrbotAdaptor-*-Velocity.jar	Velocity proxy servers
releases/libs/*.jar	Runtime libraries used by the Velocity jar
astrbot_plugin_minecraft_adapter.zip	AstrBot plugin package from CI

Backend servers resolve Java runtime libraries from plugin.yml libraries. Paper/Folia additionally use paper-plugin-loader for Paper's classpath loader. Velocity users must keep libs/ next to the Velocity jar.

Build And Test

Java plugin:

cd AstrBotAdapter
./gradlew --no-daemon clean test backendJar velocityJar releaseAll
./gradlew --no-daemon clean compileBackendJava \
  -PpaperVersion=26.2.build.40-alpha \
  -PfoliaVersion=26.1.2.build.8-stable \
  -PadventureVersion=4.26.1

AstrBot plugin:

cd astrbot_plugin_minecraft_adapter
python -m unittest discover -s tests

Dependency Maintenance

GitHub Dependabot checks GitHub Actions, Gradle, Maven, and Python dependencies weekly. Gradle versions live in AstrBotAdapter/gradle.properties; Maven versions live in AstrBotAdapter/pom.xml; Python requirements live in astrbot_plugin_minecraft_adapter/requirements.txt.

Acknowledgements

Special thanks to Railgun19457 for the original AstrBotAdapter project and Minecraft plugin foundation that MineSentinel builds on.

License

This workspace is multi-license:

• Root workspace files: Apache License 2.0, see LICENSE.
• Java Minecraft plugin: MIT License, see AstrBotAdapter/LICENSE.
• AstrBot plugin: GNU AGPL v3.0, see astrbot_plugin_minecraft_adapter/LICENSE.

Third-party dependency notes are tracked in THIRD_PARTY_LICENSES.md.