{"id":15061845,"url":"https://github.com/kvdpxne/dico","last_synced_at":"2026-01-03T01:15:25.093Z","repository":{"id":254436749,"uuid":"846522707","full_name":"kvdpxne/dico","owner":"kvdpxne","description":"A lightweight and simple library that allows you to manage the list of online players before and after Bukkit 1.7.10 version.","archived":false,"fork":false,"pushed_at":"2025-02-15T20:11:33.000Z","size":35126,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-02-15T21:19:38.601Z","etag":null,"topics":["bukkit","bukkit-library","bukkit-online-players","java","library","minecraft","minecraft-library","spigot","spigot-library"],"latest_commit_sha":null,"homepage":"","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/kvdpxne.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"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}},"created_at":"2024-08-23T11:46:21.000Z","updated_at":"2025-02-15T20:11:07.000Z","dependencies_parsed_at":"2024-08-23T13:33:18.839Z","dependency_job_id":"1859fefa-4ed8-4682-bfce-b980c6c3104f","html_url":"https://github.com/kvdpxne/dico","commit_stats":null,"previous_names":["kvdpxne/dico"],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kvdpxne%2Fdico","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kvdpxne%2Fdico/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kvdpxne%2Fdico/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kvdpxne%2Fdico/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kvdpxne","download_url":"https://codeload.github.com/kvdpxne/dico/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243809888,"owners_count":20351407,"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","bukkit-online-players","java","library","minecraft","minecraft-library","spigot","spigot-library"],"created_at":"2024-09-24T23:25:51.454Z","updated_at":"2026-01-03T01:15:25.049Z","avatar_url":"https://github.com/kvdpxne.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"## Introduction\n\n**Dico** is a small, lightweight library designed for the\n[Bukkit](https://dev.bukkit.org/) platform and its frameworks. It provides\ncompatibility for the `Bukkit.getOnlinePlayers()` method across\n[Minecraft](https://www.minecraft.net/) versions both below and above `1.7.10`.\n\n### The problem\n\nIn [Bukkit](https://dev.bukkit.org/) for [Minecraft](https://www.minecraft.net/)\n`1.7.10` and higher, the method `Bukkit.getOnlinePlayers()` returns a\n`Collection\u003cPlayer\u003e`. However, in versions prior to `1.7.10`, it returns a\n`Player[]` array. This difference creates backward compatibility issues when\ndeveloping plugins for multiple Minecraft versions.\n\n### The solution\n\n**Dico** solves this issue by allowing developers to maintain full compatibility\nwith both newer and older versions of [Minecraft](https://www.minecraft.net/).\nWith **Dico**, you can choose whether `Bukkit.getOnlinePlayers()` returns a\n`Collection\u003cPlayer\u003e` or a `Player[]`, depending on your preference and the\n[Minecraft](https://www.minecraft.net/) version you're targeting.\n\n### Key features:\n\n- Provides seamless backward compatibility for `Bukkit.getOnlinePlayers()`\n  across [Bukkit](https://dev.bukkit.org/) versions.\n- Allows developers to specify the preferred return type: `Collection\u003cPlayer`\u003e\n  or `Player[]`.\n- Easy to integrate and lightweight, adding minimal overhead to existing\n  projects.\n\n## Installation\n\n### Requirements\n\n- **Java**: 8 or higher.\n\n### Step by step\n\nThe simplest way to install the **Dico** library is by using\n[JitPack](https://jitpack.io/) with [Gradle](https://gradle.org/). Follow these\nsteps to integrate it into your project:\n\n1. Add JitPack Repository\n\nFor [Groovy](https://groovy-lang.org/) (if using `settings.gradle`), add the\nfollowing repository configuration:\n\n```groovy\ndependencyResolutionManagement {\n  repositories {\n    maven {\n      url \"https://jitpack.io\"\n      content {\n        includeGroup \"com.github.kvdpxne\"\n      }\n    }\n  }\n}\n```\n\nFor [Gradle](https://gradle.org/) [Kotlin](https://kotlinlang.org/) DSL,\nmodify your `settings.gradle.kts` file:\n\n```kotlin\ndependencyResolutionManagement {\n  repositories {\n    maven {\n      url = uri(\"https://jitpack.io/\")\n      content {\n        includeGroupAndSubgroups(\"com.github.kvdpxne\")\n      }\n    }\n  }\n}\n```\n\n2. Add Dependencies\n\nFor [Groovy](https://groovy-lang.org/) (if using `build.gradle`), add the\ndependencies for the core and API modules:\n\n```groovy\ndependencies {\n  // Include all modules of Dico\n  implementation 'com.github.kvdpxne.dico:core:VERSION'\n}\n```\n\nFor [Gradle](https://gradle.org/) [Kotlin](https://kotlinlang.org/) DSL,\nmodify your `build.gradle.kts` file:\n\n```kotlin\ndependencies {\n  // Include all modules of Dico\n  implementation(\"com.github.kvdpxne.dico:core:VERSION\")\n}\n```\n\nMake sure to replace `VERSION` with the latest release version of the library.\n\nThis approach ensures you have the **Dico** library installed in the simplest\nway via [Gradle](https://gradle.org/) using [JitPack](https://jitpack.io/).\n\n## Usage\n\nUsing the **Dico** library is extremely simple. If you need to retrieve a\ncollection of online players, instead of calling `Bukkit.getOnlinePlayers()`,\nyou can use the following methods provided by **Dico**:\n\n- To get online players as a `Collection\u003cPlayer\u003e`, use:\n\n```java\nDico.getLocalPlayers().asCollection();\n```\n\n- To get online players as a `Player[]` array, use:\n\n```java\nDico.getLocalPlayers().asArray();\n```\n\nThis allows you to easily switch between returning a `Collection\u003cPlayer\u003e` or\n`Player[]`, depending on your needs.\n\n## License\n\nThis project is licensed under the **MIT License**. This means you are free to\nuse, modify, and distribute the code in both private and commercial projects, as\nlong as you include the original license in any substantial portions of the\ncode.\n\nFor more details, please refer to the full license text in the\n[LICENSE](https://github.com/kvdpxne/dico/blob/master/LICENSE) file.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkvdpxne%2Fdico","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkvdpxne%2Fdico","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkvdpxne%2Fdico/lists"}