{"id":14969743,"url":"https://github.com/carmjos/easyplugin","last_synced_at":"2025-06-24T10:10:59.006Z","repository":{"id":39903676,"uuid":"444404721","full_name":"CarmJos/EasyPlugin","owner":"CarmJos","description":"轻松(做)插件，旨在于方便快捷的使用Bukkit实现MC中的一些功能。","archived":false,"fork":false,"pushed_at":"2025-06-09T15:49:37.000Z","size":1214,"stargazers_count":27,"open_issues_count":1,"forks_count":4,"subscribers_count":6,"default_branch":"master","last_synced_at":"2025-06-09T16:39:38.508Z","etag":null,"topics":["bukkit","bukkit-library","efficiency","java","java-library","library","spigot","spigot-library"],"latest_commit_sha":null,"homepage":"https://carmjos.github.io/EasyPlugin/","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/CarmJos.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null},"funding":{"custom":["https://donate.carm.cc"]}},"created_at":"2022-01-04T12:07:20.000Z","updated_at":"2025-06-09T15:48:37.000Z","dependencies_parsed_at":"2024-10-11T03:41:58.401Z","dependency_job_id":"f37723b9-8bc0-471a-873a-a2502079cbda","html_url":"https://github.com/CarmJos/EasyPlugin","commit_stats":{"total_commits":153,"total_committers":6,"mean_commits":25.5,"dds":0.4901960784313726,"last_synced_commit":"1d279a16a89b48a72e1cb30b1a670d146a382d8d"},"previous_names":[],"tags_count":53,"template":false,"template_full_name":null,"purl":"pkg:github/CarmJos/EasyPlugin","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CarmJos%2FEasyPlugin","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CarmJos%2FEasyPlugin/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CarmJos%2FEasyPlugin/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CarmJos%2FEasyPlugin/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/CarmJos","download_url":"https://codeload.github.com/CarmJos/EasyPlugin/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CarmJos%2FEasyPlugin/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":261649858,"owners_count":23189755,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bukkit","bukkit-library","efficiency","java","java-library","library","spigot","spigot-library"],"created_at":"2024-09-24T13:42:18.267Z","updated_at":"2025-06-24T10:10:58.981Z","avatar_url":"https://github.com/CarmJos.png","language":"Java","readme":"```text\n    ______                    ____  __            _     \n   / ____/___ ________  __   / __ \\/ /_  ______ _(_)___ \n  / __/ / __ `/ ___/ / / /  / /_/ / / / / / __ `/ / __ \\\n / /___/ /_/ (__  ) /_/ /  / ____/ / /_/ / /_/ / / / / /\n/_____/\\__,_/____/\\__, /  /_/   /_/\\__,_/\\__, /_/_/ /_/ \n                 /____/                 /____/          \n```\n\n# EasyPlugin\n\n[![version](https://img.shields.io/github/v/release/CarmJos/EasyPlugin)](https://github.com/CarmJos/EasyPlugin/releases)\n[![License](https://img.shields.io/github/license/CarmJos/EasyPlugin)](https://opensource.org/licenses/MIT)\n[![workflow](https://github.com/CarmJos/EasyPlugin/actions/workflows/maven.yml/badge.svg?branch=master)](https://github.com/CarmJos/EasyPlugin/actions/workflows/maven.yml)\n[![CodeFactor](https://www.codefactor.io/repository/github/carmjos/EasyPlugin/badge)](https://www.codefactor.io/repository/github/carmjos/EasyPlugin)\n![CodeSize](https://img.shields.io/github/languages/code-size/CarmJos/EasyPlugin)\n![](https://visitor-badge.glitch.me/badge?page_id=EasyPlugin.readme)\n\n轻松(做)插件，旨在于方便快捷的使用Bukkit实现MC中的一些功能。\n\n## 优势\n\n- 轻便独立的功能模块，按需使用，避免大量打包！\n- 详细的Javadoc与使用文档，轻松上手，方便使用！\n- 持续的更新与优化，需求不止，更新不止！\n    - 如需新功能支持，请通过 [Issues](https://github.com/CarmJos/EasyPlugin/issues) 提交功能需求。\n\n## 内容\n\n项目初创不久，加 * 的仍在开发更新中...欢迎各路大佬帮助提供本项目的开发文档~\n\n### 集合部分 (`/collection`)\n\n- All [`easyplugin-all`](collection/all)\n- Common [`easyplugin-common`](collection/common)\n\n### 主要部分 (`/base`)\n\n- Color  [`easyplugin-color`](base/color)\n    - 颜色工具类模块，提供功能全面的MC颜色解析转换工具。\n    - 支持 `\u0026+颜色代码`(原版颜色)、`§(#XXXXXX)`(RGB颜色) 与 `\u0026\u003c#XXXXXX\u003e`(前后标注RGB颜色渐变)。\n- Utils  [`easyplugin-utils`](base/utils)\n    - 通用工具类模块，该模块中的内容支持在Bungee、Bukkit使用。\n    - 本模块提供\n        - `ColorParser` 支持RGB颜色与RGB渐变色的颜色解析器。\n        - `EasyCooldown` 快速创造一个冷却时间的管理器。\n        - `JarResourceUtils` 快速读取Jar包内容的工具类。\n- Main [`easyplugin-main`](base/main)\n    - 主要接口模块，提供了方便的插件入口类与相关工具类。\n- Command [`easyplugin-command`](base/command)\n    - 指令接口模块，便于快速进行子指令的实现，并提供单独的TabComplete方法。\n    - 随本项目提供了 `SimpleCompleter` 类，用于快速创建补全的内容列表。\n- GUI [`easyplugin-gui`](base/main)\n    - 简单便捷的箱子GUI接口，可以快速实现GUI中不同图标的点击功能。\n    - 随本项目提供了 `AutoPagedGUI` 等翻页GUI抽象类。\n- Storage [`easyplugin-storage`](base/storage)\n    - 抽象存储管理器，便于实现不同的存储类型。\n    - 随本项目提供了 `FileBasedStorage`、`FolderBasedStorage` 等常用存储抽象方法。\n- Messages [`easyplugin-message`](base/messages)\n    - 随本项目提供了基于 MineConfiguration 实现的 `EasyMessages` 类。\n    - 支持多种消息配置，包括文本消息、ActionBar消息、Title消息、声音、粒子效果播放等。\n    - 支持消息间的延迟发送。\n\n### 独立项目部分\n\n\u003e 以下项目均已独立出单独项目,如需使用，**强烈建议自行引用对应的项目**，以支持完整的Javadoc并获取源码内容！\n\n- _Listener_ -\u003e [**EasyListener**](https://github.com/CarmJos/EasyListener)\n- _Configuration_ -\u003e [**MineConfiguration**](https://github.com/CarmJos/MineConfiguration)\n- _Database_ -\u003e [**EasySQL**](https://github.com/CarmJos/EasySQL)\n\n### 附属部分 (`/extension`)\n\n- [PlaceholderAPI](https://www.spigotmc.org/resources/6245/) [`easyplugin-placeholderapi`](extension/papi)\n  - PlaceholderAPI 扩展模块，提供了方便的 PlaceholderAPI 变量注册方法。\n- [Vault](https://github.com/MilkBowl/VaultAPI)* [`easyplugin-vault`](extension/vault)\n\n## 开发\n\n详细开发介绍请 [点击这里](.documentation/README.md) , JavaDoc(最新Release)\n请 [点击这里](https://carmjos.github.io/EasyPlugin) 。\n\n### 示例代码\n\n您可以 [点击这里](https://github.com/CarmJos/UltraDepository)\n查看实例项目演示，更多演示详见 [开发介绍](.documentation/README.md) 。\n\n### 依赖方式\n\n\u003cdetails\u003e\n\u003csummary\u003e展开查看 Maven 依赖方式\u003c/summary\u003e\n\n```xml\n\n\u003cproject\u003e\n    \u003crepositories\u003e\n\n        \u003crepository\u003e\n            \u003c!--采用github-repo依赖库(推荐)--\u003e\n            \u003cid\u003eEasyPlugin\u003c/id\u003e\n            \u003cname\u003eGitHub Packages\u003c/name\u003e\n            \u003curl\u003ehttps://raw.githubusercontent.com/CarmJos/EasyPlugin/repo/\u003c/url\u003e\n        \u003c/repository\u003e\n\n        \u003crepository\u003e\n            \u003c!--采用我的私人依赖库，简单方便，但可能因为变故而无法使用--\u003e\n            \u003cid\u003ecarm-repo\u003c/id\u003e\n            \u003cname\u003eCarm's Repo\u003c/name\u003e\n            \u003curl\u003ehttps://repo.carm.cc/repository/maven-public/\u003c/url\u003e\n        \u003c/repository\u003e\n\n    \u003c/repositories\u003e\n\n    \u003cdependencies\u003e\n        \u003c!--大全集版本，包含项目内所有模块--\u003e\n        \u003cdependency\u003e\n            \u003cgroupId\u003ecc.carm.lib\u003c/groupId\u003e\n            \u003cartifactId\u003eeasyplugin-all\u003c/artifactId\u003e\n            \u003cversion\u003e[LATEST RELEASE]\u003c/version\u003e\n            \u003cscope\u003ecompile\u003c/scope\u003e\n        \u003c/dependency\u003e\n\n        \u003c!--常用接口集，包含除附属插件模块外的所有模块--\u003e\n        \u003cdependency\u003e\n            \u003cgroupId\u003ecc.carm.lib\u003c/groupId\u003e\n            \u003cartifactId\u003eeasyplugin-common\u003c/artifactId\u003e\n            \u003cversion\u003e[LATEST RELEASE]\u003c/version\u003e\n            \u003cscope\u003ecompile\u003c/scope\u003e\n        \u003c/dependency\u003e\n\n        \u003c!--插件主要接口模块，包含方便的插件入口类与相关工具类--\u003e\n        \u003cdependency\u003e\n            \u003cgroupId\u003ecc.carm.lib\u003c/groupId\u003e\n            \u003cartifactId\u003eeasyplugin-main\u003c/artifactId\u003e\n            \u003cversion\u003e[LATEST RELEASE]\u003c/version\u003e\n            \u003cscope\u003ecompile\u003c/scope\u003e\n        \u003c/dependency\u003e\n\n        \u003c!-- 其他模块自行选择，详见 “内容”--\u003e\n\n    \u003c/dependencies\u003e\n\u003c/project\u003e\n```\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e展开查看 Gradle 依赖方式\u003c/summary\u003e\n\n```groovy\nrepositories {\n    // 采用github依赖库，安全稳定，但需要配置 (推荐)\n    maven { url 'https://raw.githubusercontent.com/CarmJos/EasyPlugin/repo/' }\n\n    // 采用我的私人依赖库，简单方便，但可能因为变故而无法使用\n    maven { url 'https://repo.carm.cc/repository/maven-public/' }\n}\n\ndependencies {\n\n    //大全集版本，包含项目内所有模块\n    api \"cc.carm.lib:easyplugin-all:[LATEST RELEASE]\"\n\n    //常用接口集，包含除附属插件模块外的所有模块\n    api \"cc.carm.lib:easyplugin-common:[LATEST RELEASE]\"\n\n    //插件主要接口模块，包含方便的插件入口类与相关工具类\n    api \"cc.carm.lib:easyplugin-main:[LATEST RELEASE]\"\n\n    // 其他模块自行选择，详见 “内容”\n\n}\n```\n\n\u003c/details\u003e\n\n## 支持与捐赠\n\n若您觉得本插件做的不错，您可以通过捐赠支持我！\n\n感谢您对开源项目的支持！\n\n\u003cimg height=25% width=25% src=\"https://raw.githubusercontent.com/CarmJos/CarmJos/main/img/donate-code.jpg\"  alt=\"\"/\u003e\n\n## 开源协议\n\n本项目源码采用 [The MIT License](https://opensource.org/licenses/MIT) 开源协议。\n\u003cdetails\u003e\n\u003csummary\u003e关于 MIT 协议\u003c/summary\u003e\n\n\u003e MIT 协议可能是几大开源协议中最宽松的一个，核心条款是：\n\u003e\n\u003e 该软件及其相关文档对所有人免费，可以任意处置，包括使用，复制，修改，合并，发表，分发，再授权，或者销售。唯一的限制是，软件中必须包含上述版\n\u003e 权和许可提示。\n\u003e\n\u003e 这意味着：\n\u003e - 你可以自由使用，复制，修改，可以用于自己的项目。\n\u003e - 可以免费分发或用来盈利。\n\u003e - 唯一的限制是必须包含许可声明。\n\u003e\n\u003e MIT 协议是所有开源许可中最宽松的一个，除了必须包含许可声明外，再无任何限制。\n\u003e\n\u003e *以上文字来自 [五种开源协议GPL,LGPL,BSD,MIT,Apache](https://www.oschina.net/question/54100_9455) 。*\n\u003c/details\u003e","funding_links":["https://donate.carm.cc"],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcarmjos%2Feasyplugin","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcarmjos%2Feasyplugin","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcarmjos%2Feasyplugin/lists"}