{"id":24779210,"url":"https://github.com/carmjos/mineuser","last_synced_at":"2025-03-24T03:28:18.525Z","repository":{"id":272831581,"uuid":"917801176","full_name":"CarmJos/MineUser","owner":"CarmJos","description":"MineCraft服务器通用用户键值调取、查询接口。","archived":false,"fork":false,"pushed_at":"2025-03-11T20:40:12.000Z","size":315,"stargazers_count":0,"open_issues_count":1,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-03-11T21:32:52.999Z","etag":null,"topics":["bungeecord-plugin","framework","minecraft-plugin","spigot-plugin","user","velocity-plugin"],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"lgpl-3.0","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},"funding":{"github":["CarmJos"],"custom":["https://donate.carm.cc"]}},"created_at":"2025-01-16T17:09:22.000Z","updated_at":"2025-03-11T20:40:12.000Z","dependencies_parsed_at":null,"dependency_job_id":"2e128b14-9de2-4d1d-ac23-f21a452198ca","html_url":"https://github.com/CarmJos/MineUser","commit_stats":null,"previous_names":["carmjos/mineuser"],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CarmJos%2FMineUser","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CarmJos%2FMineUser/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CarmJos%2FMineUser/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CarmJos%2FMineUser/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/CarmJos","download_url":"https://codeload.github.com/CarmJos/MineUser/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245203827,"owners_count":20577228,"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":["bungeecord-plugin","framework","minecraft-plugin","spigot-plugin","user","velocity-plugin"],"created_at":"2025-01-29T09:36:05.960Z","updated_at":"2025-03-24T03:28:18.510Z","avatar_url":"https://github.com/CarmJos.png","language":"Java","readme":"```text\n   __  ____          __  __\n  /  |/  (_)__  ___ / / / /__ ___ _______\n / /|_/ / / _ \\/ -_) /_/ (_-\u003c/ -_) __(_-\u003c\n/_/  /_/_/_//_/\\__/\\____/___/\\__/_/ /___/\n```\n\n# MineUser\n\n[![version](https://img.shields.io/github/v/release/CarmJos/MineUser)](https://github.com/CarmJos/MineUser/releases)\n[![License](https://img.shields.io/github/license/CarmJos/MineUser)](https://www.gnu.org/licenses/lgpl-3.0.html)\n[![workflow](https://github.com/CarmJos/MineUser/actions/workflows/maven.yml/badge.svg?branch=master)](https://github.com/CarmJos/MineUser/actions/workflows/maven.yml)\n![CodeSize](https://img.shields.io/github/languages/code-size/CarmJos/MineUser)\n![](https://visitor-badge.glitch.me/badge?page_id=MineUser.readme)\n\nMineCraft服务器通用用户键值调取、查询接口。\n\n## 开发\n\n本插件/依赖库提供了一个通用的用户键记录，其格式如下\n\n```java\nrecord UserKey(\n        long id, @NotNull UUID uuid,\n        @NotNull String name\n)\n```\n而通过 `MineUserAPI` 入口类，您可以快速操作以下方法：\n\n- `@Nullable UserKey key(UserKeyType\u003c?\u003e type, Object param)`\n- `@Nullable UserKey key(long id)`\n- `@Nullable UserKey key(@NotNull UUID uuid)` \n- `@Nullable UserKey key(@NotNull String username)`\n- `@Nullable Long uid(@NotNull String username)`\n- `@Nullable Long uid(@NotNull UUID userUUID)` \n- `@Nullable String username(long id)` \n- `@Nullable String username(@NotNull UUID userUUID)`\n- `@Nullable UUID uuid(long id)`\n- `@Nullable UUID uuid(@NotNull String username)`\n\n对键值对的获取有基于Redis的预先缓存，但仍然建议您在使用时进行异步操作。\n\n### 依赖方式\n\n#### Maven 依赖\n\n\u003cdetails\u003e\n\u003csummary\u003e远程库配置\u003c/summary\u003e\n\n```xml\n\n\u003cproject\u003e\n    \u003crepositories\u003e\n        \u003crepository\u003e\n            \u003c!--采用github依赖库，实时更新，但需要配置 (推荐) --\u003e\n            \u003cid\u003eMineUser\u003c/id\u003e\n            \u003cname\u003eGitHub Packages\u003c/name\u003e\n            \u003curl\u003ehttps://maven.pkg.github.com/CarmJos/MineUser\u003c/url\u003e\n        \u003c/repository\u003e\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    \u003c/repositories\u003e\n\u003c/project\u003e\n```\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e通用原生依赖\u003c/summary\u003e\n\n```xml\n\n\u003cproject\u003e\n    \u003cdependencies\u003e\n        \u003cdependency\u003e\n            \u003cgroupId\u003ecc.carm.lib\u003c/groupId\u003e\n            \u003cartifactId\u003emineuser-api\u003c/artifactId\u003e\n            \u003cversion\u003e[LATEST RELEASE]\u003c/version\u003e\n            \u003cscope\u003ecompile\u003c/scope\u003e\n        \u003c/dependency\u003e\n    \u003c/dependencies\u003e\n\u003c/project\u003e\n```\n\n\u003c/details\u003e\n\n#### Gradle 依赖\n\n\u003cdetails\u003e\n\u003csummary\u003e远程库配置\u003c/summary\u003e\n\n```groovy\nrepositories {\n    \n    // 采用github依赖库，实时更新，但需要配置 (推荐)\n    maven { url 'https://maven.pkg.github.com/CarmJos/MineUser' }\n\n    // 采用我的私人依赖库，简单方便，但可能因为变故而无法使用\n    maven { url 'https://repo.carm.cc/repository/maven-public/' }\n}\n```\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e通用原生依赖\u003c/summary\u003e\n\n```groovy\ndependencies {\n    api \"cc.carm.lib:mineuser-api:[LATEST RELEASE]\"\n}\n```\n\n\u003c/details\u003e\n\n## 支持与捐赠\n\n若您觉得本插件做的不错，您可以通过捐赠支持我！ 感谢您对开源项目的支持！\n\n## 开源协议\n\n本项目源码采用 [GNU LESSER GENERAL PUBLIC LICENSE](https://www.gnu.org/licenses/lgpl-3.0.html) 开源协议。\n","funding_links":["https://github.com/sponsors/CarmJos","https://donate.carm.cc"],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcarmjos%2Fmineuser","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcarmjos%2Fmineuser","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcarmjos%2Fmineuser/lists"}