Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/dscalzi/skychanger
Change the color of your personal sky in Minecraft ⛅️⚡️🌄
https://github.com/dscalzi/skychanger
bukkit minecraft sky spigot
Last synced: 2 months ago
JSON representation
Change the color of your personal sky in Minecraft ⛅️⚡️🌄
- Host: GitHub
- URL: https://github.com/dscalzi/skychanger
- Owner: dscalzi
- License: mit
- Created: 2018-03-08T19:56:59.000Z (almost 7 years ago)
- Default Branch: master
- Last Pushed: 2022-05-13T01:30:31.000Z (over 2 years ago)
- Last Synced: 2024-10-03T12:42:13.373Z (3 months ago)
- Topics: bukkit, minecraft, sky, spigot
- Language: Java
- Homepage:
- Size: 457 KB
- Stars: 31
- Watchers: 4
- Forks: 7
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE.txt
Awesome Lists containing this project
README
[](https://github.com/dscalzi/SkyChanger/actions/workflows/build.yml) [](https://github.com/dscalzi/PluginBadges) [](https://github.com/dscalzi/SkyChanger/blob/master/LICENSE.txt)  [](https://discordapp.com/invite/Fcrh6PT)
SkyChanger is a light-weight plugin for Spigot and Sponge. The main function of this plugin is to change the color of the sky for yourself, a specific player, a specific world, or everyone. This plugin functions by sending packets with a specified value to the target player(s).
*Like the project? Leave a ⭐ on the repository!*
***
# Feature List
* Allow players to change the color of their personal sky.
* Change the sky color for specific players.
* Change the sky color for a specific world.
* Change the sky color for everyone online.
* Freeze/Unfreeze yourself, others, a world, or everyone online.
* Configurable limits to the range of packets that can be sent.
* Usage messages tailored to specific users based on permission level.
* Multilanguage support.
* Metrics tracking by [bStats](https://bstats.org/plugin/bukkit/SkyChanger/350).
**If you would like to contribute your language or correct an incorrect translation, [follow this quick guide](https://github.com/dscalzi/SkyChanger/wiki/Translation-Guide).**
You can find more extensive details on the [wiki](https://github.com/dscalzi/SkyChanger/wiki).
***
# Building and Contributing
If you would like to contribute to SkyChanger, feel free to submit a pull request. The project does not use a specific code style, however please keep to the conventions used throughout the code.
You can build SkyChanger using [Gradle](https://gradle.org/). Clone the repository and run the following command.
```shell
$ gradlew build
```
---
# Developer API
If you want to hook SkyChanger into your own plugin or simply want to extend functionality, you may use the provided API. If you feel the API is missing anything, or should be changed, please [let us know](https://github.com/dscalzi/SkyChanger/issues).
### GitHub Packages
SkyChanger 5.x+ will be hosted on GitHub packages. See https://github.com/dscalzi/SkyChanger/packages
SkyChanger 4.x and earlier were hosted on jcenter, which shutdown.
*Javadocs are not hosted, however they are provided on the maven repository.*
### Gradle
See https://docs.github.com/articles/configuring-gradle-for-use-with-github-package-registry/ to learn more.
```gradle
dependencies {
// For Bukkit
implementation 'com.dscalzi:skychanger-bukkit:VERSION'
// For Sponge
implementation 'com.dscalzi:skychanger-sponge:VERSION'
}
```
### Maven
See https://docs.github.com/articles/configuring-apache-maven-for-use-with-github-package-registry/ to learn more.
```XML
com.dscalzi
skychanger-bukkit
VERSION
com.dscalzi
skychanger-sponge
VERSION
```
### Example Usage
```java
/**
* Example usage of the API. The following implementation
* would not be practical, it exists only to demonstrate
* the API capabilities.
*
* @param player The player to experiment on.
*/
public void skychangerTests(Player player) {
// Get a reference to the API.
final SkyAPI api = SkyChanger.getAPI();
// Change the sky and save the result.
// Equivalent to /SkyChanger 3
boolean result1 = api.changeSky(SkyChanger.wrapPlayer(player), SkyPacket.RAIN_LEVEL_CHANGE, 3F);
if(result1) {
player.sendMessage("Why did the sky turn red?");
}
// Equivalent to /SkyChanger 4 8
boolean result2 = api.changeSky(SkyChanger.wrapPlayer(player), SkyPacket.RAIN_LEVEL_CHANGE, 4F)
&& api.changeSky(SkyChanger.wrapPlayer(player), SkyPacket.THUNDER_LEVEL_CHANGE, 8F);
if(result2) {
player.sendMessage("Why did the sky turn light blue?");
}
// Freeze the player.
boolean result3 = api.freeze(SkyChanger.wrapPlayer(player));
if(result3) {
player.sendMessage("Where did the land go?");
// Unfreeze the player.
result3 = api.unfreeze(SkyChanger.wrapPlayer(player));
if(result3) {
player.sendMessage("You've been unfrozen! Press (F3 + A) to reload chunks.");
}
}
}
```
---
# Links
* [Spigot Resource Page](https://www.spigotmc.org/resources/skychanger.37524/)
* [Dev Bukkit Page](https://dev.bukkit.org/projects/skychanger)
* [Sponge Ore Page](https://ore.spongepowered.org/TheKraken7/SkyChanger)
* [Suggest Features or Report Bugs](https://github.com/dscalzi/SkyChanger/issues)