Freedom Minecraft 插件
Paper 1.21.11
本插件部署于 play.yaszu.xyz
本插件的文档位于 docs.yaszu.xyz
以我在一月聆听的一首具有自由主题的歌曲命名。

本项目需要以下依赖项:
- Packet Events
- World Edit
- Skins Restorer
- Lib's Disguises
- BetterModel
如果你只想从源码构建项目,请直接前往 实际构建项目
每次加入服务器时,你都会被移除管理员权限,这是正在运行的 Sudo 系统,你需要重新为自己授权,这旨在用于实际服务器应用,抱歉
灵感来源
在创建这个项目时,我受到了多种媒体的启发,范围从热门游戏 Undertale 一直到像 backrooms 这样的视频系列。
为什么要创建这个?
这个项目是为我夏天的朋友基于 Minecraft 的服务器而制作的,我想要一个拥有所有由我自己创建的功能的服务器,这样我就可以调试它们。我经常遇到自己无法修复的错误和问题,因为我没有创建这些程序。于是我想……
如果我能够创建这个插件,如果一切出错,也许我能更快地修复它?
这是什么插件?
这是一个综合性的插件,由多个子系统组成,以实现几个基本概念。该插件实现了;
- 生命系统,包含死后可以执行的操作
- 通常可获得的 10 套动作集
- 可扩展的物品系统
- 基于单词的魔法(可扩展)
- 每个系统均可模块化,允许我日后对其进行扩展。
- Sudo 系统将管理员配置文件与其默认配置文件分离,使他们可以与其他人一起玩生存模式
生命系统
在生命系统中,默认生命值数量有一个硬编码值(9)。该系统完全确保只有当玩家被其他玩家杀死时,生命值才会减少。我之所以以这种方式实现而不是采用“硬核”方式,是因为如果我们必须玩硬核模式,我和我的朋友连 一天 都撑不下去。那样就不好玩了。尽管如此,我还是希望 死亡 有意义,尤其是被玩家击杀的情况。因此我实现了生命系统,即使玩家被从世界上抹去,他们仍然可以采取行动。当玩家死亡时,他们会变成幽灵,他们不能以任何方式与世界互动,但他们实际上仍然身处世界之中。他们理论上仍然可以漫游,不过我实现了一个系统,让他们拥有更多的 影响力。
灵魂附魔(未完成 100%)
当某人变成幽灵时,他们可以将自己的 灵魂 附魔到另一个人的武器中。当使用能力时,这会为持用者提供增益效果。
动作集
在此插件中,有 20 个在生存体验中可以获得的 可获取 动作集,但使用管理员命令则有 22 个。加入服务器时可用的 10 个 自然 动作集都以颜色命名。它们是:
- Blue
- Red
- Purple
- Mocha
- Cafe
- Green
- Black
- Orange
- Yellow
它们各自拥有独特的动作集和能力,可以帮助玩家脱颖而出。有些主要用于攻击,而另一些则用于辅助。我还没有找到可靠的防御实现方法。
基于单词的魔法
在此插件中,有一个完善的魔法系统,支持移动施法以及你可以找到或创建的仪式法阵。在该子系统中,有一组单词会被解析,然后转化为世界中真实发生的行为。当前的关键词列表包括:
- Location
- Delay
- Destruction
- Teleportation
- Amplification
- Area
- Effect
- Range
- Shock
- moveset
- Province
- up
- down
- look
- rain
- sun
- thundering
- regeneration
- haste
- 等等
你可以链接这些关键词,例如这里有一个简单的破坏咒语:
destruction location 420 70 420 range 1
然后你可以使用以下方式增强它:
destruction location 420 70 420 range 25 amplification
尽管你可以通过更具创造性的尝试和堆叠来使其更强,同时试图保持成本较低
Sudo 系统
在项目内部,我希望能够在玩游戏的同时保留创造模式访问权限和管理员权限,以防情况失控,所以我实现了 Sudo 系统来 充当 一个单独的账户,而不必为此付费。所有信息都存储在持久数据容器中,并且所有管理员都是 硬编码 的,以防止篡改。(而且我很懒……)
通过使用以下命令克隆项目:
git clone https://github.com/Yaszu-Mage/Freedom
然后在目录中执行以下操作来构建项目
将 "path/to/output" 替换为你想要构建到的目录
./gradlew build -PshadowJarPath="path/to/output"
它应该会构建一个 shadow jar,如果有任何问题,请在 Discord 上联系我。Discord 上的用户名为 Yaszu :3
快速设置
我为 Windows 创建了一个快速设置脚本,如果你不想尝试自己设置服务器,因为它无聊得要死……创建一个新文件并将 此处 列出的内容粘贴进去,文件名应为 "setup.bat"(不带引号)
如果你想再次运行它,生成的启动文件是 start.bat :D
顺便说一句,如果你是审阅者,我的 HackaTime 很奇怪,因为我试图将其与我的 Waka Time 合并,并且我安装了浏览器扩展,我已经提交了多次工单来解决这个问题但均未成功,请不要把我杀了
Freedom Minecraft Plugin
Paper 1.21.11
This plugin is deployed at play.yaszu.xyz
THIS PLUGIN HAS DOCUMENTATION AT docs.yaszu.xyz
Named After a Song I was listening to with the freedom motif in January.

This project requres these dependencies;
- Packet Events
- World Edit
- Skins Restorer
- Lib's Disguises
- BetterModel
If you just want to build the project from source, just head to Actually building the project
YOU WILL BE STRIPPED FROM ADMIN EVERY TIME YOU JOIN THE SERVER, THIS IS THE SUDO SYSTEM IN PLAY, YOU WILL NEED TO RE OP YOURSELF, THIS IS MEANT FOR ACTUALY SERVER APPLICATIONS, sorry
Inspirations
When creating this project I was inspired by a miriad of media ranging from the hit game Undertale, all the way to video series such as the backrooms.
Why Create this?
This project has been made for my summer friend based Minecraft server, I wanted to have a server with all the features created by me so I could debug them. I would often run into errors and problems I could not fix myself, because I did not create the program. I thought to myself...
If I could create the plugin, maybe I could fix it significantly faster if everything went wrong?
What is this plugin?
This is a comprehensive plugin comprised of multiple subsystems to achieve a couple basic concepts. This plugin implements;
- Life System with things to do after death
- 10 movesets normally obtainable
- Expandable Item System
- Word Based Magic (Expandable)
- Every System being modulable, allowing me to expand on it later.
- Sudo system seperating ADMIN profiles with their default Profiles so they can player survival with everyone else
Life System
Within the life system there is a hardprogramed value for the default amount of lives (9). This system fully ensures that the player lives are only subtracted IF the player dies by another player. The reason I implemented it in this fashion instead of in a "hardcore" way is because neither myself, nor my friends would last a DAY if we had to play hardcore. It would not be fun. Though I still wanted death to mean something, especially that by a player. So I implemented the life system, with actions players can do, even if they are wiped off the face of the world. When players die, they become ghosts, they may not interact with the world in anyway, though they are still, in effect, inside of the world. They can techinically still roam, though I implemented a system so they could have more influence.
Soul Imbuement (Not 100% done)
When someone becomes a ghost, they can imbue their soul within someone else's weapon. This provides buffs to the person weilding the weapon, when the abilities are used.
Movesets
Within this plugin, there are 20 OBTAINABLE movesets that you can get within a survival experience, but there are 22 using admin commands. There are 10 natural movesets available when joining the server, and they are all named after colors. There is:
- Blue
- Red
- Purple
- Mocha
- Cafe
- Green
- Black
- Orange
- Yellow
They each have unique movesets and abilities that can help set the player apart from others. Some are mainly meant for attack, while others are meant for support. I have not found a reliable way to implement defense.
Word based Magic
Within this plugin, there is a fully fleshed out magic system, with mobile casting aswell as ritual circles you can find or create. Within the subsystem, there is a set of words that are then parsed, then turned into real actions that can happen within the world. The current list of keywords include:
- Location
- Delay
- Destruction
- Teleportation
- Amplification
- Area
- Effect
- Range
- Shock
- moveset
- Province
- up
- down
- look
- rain
- sun
- thundering
- regeneration
- haste
- and much more
You can chain these keywords, for example here is a simple destruction spell:
destruction location 420 70 420 range 1
Then you can amplify it by using:
destruction location 420 70 420 range 25 amplification
Though you could make it stronger through more creative attempts and stacking to try and keep costs down
Sudo System
Within the project, I wanted to be able to play the server while still having creative access and moderator access if something got out of hand, so I implemented the sudo system to ACT as a seperate account, without having to pay for one. All information is stored within the persistent data container, and all admins are HARDCODED to try and prevent tampering. (also I am lazy...)
Create a clone of the project by using:
git clone https://github.com/Yaszu-Mage/Freedom
Then build the project by doing within the directory
Replace "path/to/output" to the directory you want to build it to
./gradlew build -PshadowJarPath="path/to/output"
It should build a shadow jar, please reach out to me on Discord if there are any issues. Yaszu on discord :3
Quick Setup
I have created a quick setup script for Windows, if you do not want to try and attempt to setup the server yourself because it is boring as heck... make a new file and paste in the contents listed here filename should be "setup.bat" (without the quotes)
If you want to run it again, the generated run start.bat :D
BTW IF YOU ARE A REVIEWER, MY HACKATIME IS WEIRD BC I TRIED TO MERGE WITH MY WAKA TIME AND I HAD THE BROWSER EXTENSION, I ALREADY SUBMITTED MULTIPLE TICKETS TO GET THIS FIXED TO NO AVAIL PLEASE DONT SHOOT ME DEAD
评论 0
登录后参与评分
还没有评论,来抢沙发吧