Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/caishangqi/charming-realm-system

The All-in-One player realm solution plugin, provide each player an individual world in server!
https://github.com/caishangqi/charming-realm-system

bungeecord minecraft-plugin spigot-plugin

Last synced: about 2 hours ago
JSON representation

The All-in-One player realm solution plugin, provide each player an individual world in server!

Host: GitHub
URL: https://github.com/caishangqi/charming-realm-system
Owner: Caishangqi
License: gpl-3.0
Created: 2024-07-29T20:03:47.000Z (4 months ago)
Default Branch: master
Last Pushed: 2024-09-16T03:39:02.000Z (2 months ago)
Last Synced: 2024-09-16T05:12:00.096Z (2 months ago)
Topics: bungeecord, minecraft-plugin, spigot-plugin
Language: Java
Homepage:
Size: 977 KB
Stars: 1
Watchers: 1
Forks: 0
Open Issues: 1
Metadata Files:
- Readme: readme.md
- License: LICENSE

Awesome Lists containing this project

README

        # Charming Realm

![project-title-bg](https://github.com/user-attachments/assets/624149f2-23cc-4ce7-968c-5eda04c7c752)







基于插件 SelfHomeMain 的高版本领域系统移植版本















## 概述

该插件提供每个玩家一个独立世界的功能，有效减少区块占用、卡顿、区块保存困难及档案损坏等问题。玩家可以自主管理自己的世界，或邀请其他玩家加入共同建造。

通过菜单，玩家可以管理领域的合作建设者，并选择是否将自己的领域展示到公共菜单中，以便其他玩家访问。**→** [原帖地址](https://www.minebbs.com/resources/selfhomemain-1-7-10-1-21.8693/)









领域导航菜单和领域选择列表











领域创建菜单选择列表 - 动态Title



## 特性

> *斜体* 内容代表原插件 `SelfHomeMain` 不同的特性,该版本目前更改原插件GUI的可读性和外观, 随着版本更新该插件会逐步修改其他可以改善的地方

- 创建玩家独立世界 （支持超平坦 / 默认生存 / 及其他设定的模板地图）

- 设置或更改独立世界出生点,信任名单

- 独立世界世界边界,并且可以使用货币升级范围大小

- 同步世界时间功能,季节等

- 设置独立世界最大的`Tiles`数量

- *用户界面缓存,插件的用户界面会缓存,下次打开无需重新生成*

- *领域设置面板,设置操作也可以由其他领域成员执行*

- *支持将创建的玩家领域统一放到文件夹下(playerrealms)管理*

- *支持离线玩家领域玩家头颅和领域名称(玩家称号前缀)展示*

- *分离出模板创建领域时的磁盘拷贝操作至线程池*

- *添加创建队列,默认5个线程处理玩家的领域创建请求*

- *模板选择菜单,支持动态界面Title刷新,按钮选择时自定义样式*

- *在指定菜单区域内展示玩家领域头像而非直接填充*

- *给予按钮不同的样式基于当前页数*

- *支持HexColor,使用 `#83c22d` 充当颜色代码*

- *GUI中的物品名称现在也可以使用占位符*

  ...

## 权限系统重置

目前正在重构权限系统,包含的5个基础权限组为 `Owner 所有者`, `Operator 管理者`,`Member 成员`,和 `Visitor 访问者` 以及 `Banned 被封禁` 

| 名称         | 建造 | 邀请 | 封禁 | 访问 | 设置可见性 |    最大晋升    | 设置出生点 |

|------------|:--:|----|:--:|:--:|:-----:|:----------:|:-----:|

| `Owner`    | ✅  | ✅  | ✅  | ✅  |   ✅   | `Operator` |   ✅   |

| `Operator` | ✅  | ✅  | ✅  | ✅  |   ✅   |  `Member`  |   ✅   |

| `Member`   | ✅  | ❌  | ❌  | ✅  |   ❌   |   `None`   |   ❌   |

| `Visitor`  | ❌  | ❌  | ❌  | ✅  |   ❌   |   `None`   |   ❌   |

| `Banned`   | ❌  | ❌  | ❌  | ❌  |   ❌   |   `None`   |   ❌   |

- 在领域主界面中你可以**右键**头颅图标打开该领域的设置面板 (如果你有权限的话),**左键**则打开你自己的领域设置面板 (如果有的话)

- 使用指令 `/realm invite/remove/ban <玩家名称> from <所有者名称>` 操作指定领域玩家`邀请`/`移除`/`封禁`操作

- 使用指令 `/realm invite/remove/ban <玩家名称>` 操作你的领域玩家`邀请`/`移除`/`封禁`操作

- 当使用 `/realm invite` 后默认给予的权限是 `Member`, 若需要更改你需要去设置面板进行设置

- 当使用 `/realm remove` 后该玩家的权限会变为 `Visitor`

- 当使用 `/realm ban` 后该玩家的权限会变为 `Banned`

>**危险行为**: 如果你希望你的 `Operator` 可以将其他成员的权限也提升至 `Operator` 则可以打开设置面板并启用面板中的 `Enable perm proliferation` 允许管理员 *权限增生*. 只不过不建议这样做

## 占位符

> 当前注册的占位符标识有2个分别是:`SelfHomeMain`和`realm`,这里只说明模块 `realm`

> 的占位符使用,关于占位符模块`SelfHomeMain`

> 的使用请请到 [原帖地址](https://www.minebbs.com/resources/selfhomemain-1-7-10-1-21.8693/)

| 占位符名称                         | 参数               | 介绍         |

|-------------------------------|------------------|------------|

| `%realm_world_player_%` | `` 领域创建者名称 | 当前领域内的在线玩家 |

| `%realm_time_created_%` | `` 领域创建者名称 | 领域创建时间     |

### 内部占位符

> 内部占位符通常在插件的GUI `gui_.yml`和语言 `message_cn.yml`配置文件中使用,他们无法被placeholderAPI解析，也通常没有参数

| 占位符名称                    | 介绍              |

|--------------------------|-----------------|

| `{REALM_CURRENT_PLAYER}` | 当前领域内的在线玩家      |

| `{REALM_CURRENT_PLAYER}` | 领域创建时间          |

| `{REALM_PERMISSION}`     | 该玩家在领域的权限组      |

| `{REALM_NAME}`           | 领域名称 (完整名称+权限组) |

## 待更新

| 内容                      | 优先级 | 状态  |

|:------------------------|:---:|:---:|

| 更好看的UI适配                | 最高  | 95% |

| 插件热重载                   | 最高  | 50% |

| 将GUI内部的Action操作解耦       | 较高  | 10% |

| 玩家添加信任名单时不用在领域内执行       | 较高  |  ✅  |

| 领域配置成员在线时保持加载           | 正常  | 10% |

| PlaceholderAPI 支持玩家头颅展示 | 正常  |  ✅  |

| 更改配置文件记录创建者和创建时间        | 正常  |  ✅  |

| 领域列表基于页数自动判断按钮样式        | 正常  |  ✅  |

| 领域权限修改,信任GUI重置          | 正常  | 60% |

| 将创建GUI的逻辑操作适配 bungee    | 最低  | 📌  |

## 待修复

> 项目中关于Placeholder的代码有部分存在着问题,包括不限于在 `setPlaceholders(null, str);` 字符串时没有传入`OfflinePlayer`,这样做会导致绝大部分插件的Placeholder调用失败. 后续修复应该重写插件`API.java`中的分支并默认传入OfflinePlayer (无论何时)

- 插件无法进行热重载,出现 `Variable.java` 类的 `ClassNotDefine` `(错误)`

- 插件输出消息给玩的时自动进行placeholder的解析 `(跟进 → 懒得改)`

- 跟进领域创建gui中的创建判断,玩家拥有领域时无法打开界面 `(已修复)`

- 配置文件`GUI.yml` 中,若按钮 `CustomName` 相同则会触发相同脚本 `(以弃用)`

- 在gui菜单的物品lore中不支持调用luck-perms插件的占位符因为这些占位符需要读取在线/离线玩家实例 `(使用静态文本实现)`

## 特别说明

这是一个专门给服务器使用的插件，主要需求会依照服务器需求进行配置，您的需求可能会被延后，感谢谅解。

> This is a plugin specially used for the server. The main requirements will be configured according to the server

> requirements. Your requirements may be delayed. Thank you for your understanding.

您可能会注意到，本插件使用了一些其他服务器的游戏资源和设计。对此，您可能会感到疑惑甚至愤怒：“这难道不是抄袭吗？”

事实上，这些资源仅用于确保GUI设计的一致性和美观性。而且，这些资源并不会通过本项目传播或被获取，因此不会涉及版权或其他法律问题。

> You might notice that this plugin uses some game resources and designs from other servers. This may raise concerns or

> even anger, as you might think, "Isn't this plagiarism?" However, these resources are only used to ensure consistency

> and aesthetics in the GUI design. Moreover, these resources will not be distributed or obtained through this project,

> thus avoiding any copyright or legal issues.

部分材质来源于Minecraft服务器Origin Realm以及插件ItemsAdder。请注意，您不能以任何方式传播这些资源。

> Some materials are sourced from the Minecraft server Origin Realm and the plugin ItemsAdder. Please note that you are

> not permitted to distribute these resources in any way.