Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/aleksandarharalanov/hats
Players can wear blocks as hats. (+Dynamic lightning)
https://github.com/aleksandarharalanov/hats
bukkit craftbukkit craftbukkit-1060 craftbukkit-1092 minecraft minecraft-beta minecraft-plugin project-poseidon uberbukkit
Last synced: about 1 month ago
JSON representation
Players can wear blocks as hats. (+Dynamic lightning)
- Host: GitHub
- URL: https://github.com/aleksandarharalanov/hats
- Owner: AleksandarHaralanov
- License: mit
- Created: 2024-06-05T06:12:19.000Z (8 months ago)
- Default Branch: master
- Last Pushed: 2024-12-21T04:32:09.000Z (about 1 month ago)
- Last Synced: 2024-12-21T05:22:26.368Z (about 1 month ago)
- Topics: bukkit, craftbukkit, craftbukkit-1060, craftbukkit-1092, minecraft, minecraft-beta, minecraft-plugin, project-poseidon, uberbukkit
- Language: Java
- Homepage: https://modrinth.com/plugin/hats-b1.7.3
- Size: 18.9 MB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
# Hats
## What's Hats?
**Hats** is a Minecraft plugin designed for servers running version b1.7.3.
It allows players to wear blocks in the helmet slot as hats and optionally emit light from these hats, depending on the configured blocks.
The plugin also includes sound and visual effects to enhance the experience of wearing and interacting with hats.
### Features
- Wear any block as a hat. ([Block IDs 1-96](https://raw.githubusercontent.com/AleksandarHaralanov/Hats/refs/heads/master/assets/Items.png))
- Configure which hats will emit light around the player, visible to everyone.
- Modify the radius and intensity of the emitted light.
- Enjoy sound and visual effects when wearing hats or switching the light on/off.
- Ability to disable certain features.
- **Side features:**
- **Condition checks:** No block held in hand, Item cannot be worn as a hat, Held block is already worn as a hat, Swap between new and old hat, Dropping the old hat on the ground when a new one is equipped with a full inventory.
- Ensures only one unit of a block is worn in the helmet slot, preventing players from using it as an additional inventory slot.
- Checks for a newer version of the plugin and provides a download link in the console if available.
### Download
Latest releases of **Hats** can be found here on [GitHub](https://github.com/AleksandarHaralanov/Hats/releases).
Alternatively, you can also download through [Modrinth](https://modrinth.com/plugin/hats-b1.7.3/versions).
The plugin is fully open-source and transparent. If you'd like additional peace of mind, you're welcome to scan the `.jar` file using [VirusTotal](https://www.virustotal.com/gui/home/upload).
### Requirements
Your b1.7.3 server must be running one of the following APIs: CB1060-CB1092, [Project Poseidon](https://github.com/RhysB/Project-Poseidon) or [UberBukkit](https://github.com/Moresteck/Project-Poseidon-Uberbukkit).
### Usage
By default, only OPs have permission.
Use PermissionsEx or similar plugins to grant groups the permission, enabling the commands.
> [!NOTE]
> Commands, permissions, and configs below are examples of the latest **pre-release** of Hats. Not to be confused with the stable release.
#### Commands:
- `/hat` - `hats.wear` - Wear the block in hand as a hat.
- `/hat effects` - `hats.wear` - Toggle personal effects.
- `/hat light` - `hats.light` - Toggle personal hat light.
- `/hat light view` - View hat light source blocks.
- `/hat about` - See Hats' information.
- `/hat settings ` - `hats.settings` - Manage Hats' settings. (Staff):
- `reload` - Reload Hats' configuration.
- `toggle ` - Toggle features.
- `alter ` - Alter hat light behavior.
- ` <1-96>` - Modify hat light source blocks.
#### Permissions:
##### Single permissions:
- `hats.wear` - Allows the player to wear blocks as hats.
- `hats.light` - Allows specific hats to emit light and be toggled by the player when worn.
- `hats.settings` - Allows the player to reload and change the config.
##### Wildcard permissions:
- `hats.*` - Wildcard permission granting everything.
- `hats.perks` - Grants `hats.wear` and `hats.light`.
#### Configuration
Automatically generates configuration files `config.yml` and `players.yml` located at `plugins/Hats/`.
##### Default `config.yml`:
```yaml
hats:
toggle: true
effects: true
light:
toggle: true
radius: NARROW
level: LOW
source:
- 10
- 11
- 50
- 51
- 52
- 62
- 89
- 90
- 91
```
##### Default `players.yml`:
```yaml
players:
light-enabled: []
effects-disabled: []
```
> [!CAUTION]
> If you made changes to the configuration while the server is running, it is strongly recommended to use `/hat settings reload` to apply the changes instead of `/reload`.