https://github.com/ptthanh02/smart-spawner
A powerful and intuitive GUI-based mob spawner plugin for Minecraft servers. Supports Spigot, Paper & Bukkit!
https://github.com/ptthanh02/smart-spawner
bukkit minecraft paper spigot
Last synced: 4 months ago
JSON representation
A powerful and intuitive GUI-based mob spawner plugin for Minecraft servers. Supports Spigot, Paper & Bukkit!
- Host: GitHub
- URL: https://github.com/ptthanh02/smart-spawner
- Owner: ptthanh02
- License: other
- Created: 2024-11-12T06:46:01.000Z (7 months ago)
- Default Branch: main
- Last Pushed: 2025-02-19T11:44:01.000Z (4 months ago)
- Last Synced: 2025-02-19T12:32:18.378Z (4 months ago)
- Topics: bukkit, minecraft, paper, spigot
- Language: Java
- Homepage: https://modrinth.com/plugin/smart-spawner-plugin
- Size: 839 KB
- Stars: 3
- Watchers: 1
- Forks: 6
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
# Smart Spawner - GUI Spawner Plugin ✨
[](https://modrinth.com/plugin/smart-spawner-plugin)
[](https://www.spigotmc.org/resources/smart-spawner-gui-spawner-plugin%E2%9C%A8-1-21-1-21-3-%EF%B8%8F.120743/)
[](https://discord.gg/zrnyG4CuuT)
[](LICENSE)
**A powerful and intuitive GUI-based spawner plugin for Minecraft servers**
[](https://modrinth.com/plugin/smart-spawner-plugin)
[](https://www.spigotmc.org/resources/120743/)
## ✨ Key Features
- **Intuitive GUI** - Allows players effortlessly view, manage, and interact with spawners.
- **Storage System** - Built-in storage GUI for spawner drops
- **Sell Feature** - Sell items directly from storage GUI from other shop plugins
- **Spawner Stacking** - Stack multiple spawners to save space
- **Hologram Support** - Display important information above spawners
- **Extensive Customization** - Configure spawner behavior, drops, and more
- **Multi-Language Support** - Easily customize all plugin messages
- **Performance Optimized** - Minimal impact on server performance
## 🚀 Getting Started
### Prerequisites
- Minecraft Server (Bukkit, Paper, or compatible fork)
- Using a newer fork like **Folia**? Check out [Smart Spawner for Folia (Beta)
](https://github.com/maiminhdung/Smart-Spawner-Plugin)
- Server version 1.20 - 1.21.4
### Installation
1. Download the latest version from [Modrinth](https://modrinth.com/plugin/smart-spawner-plugin) or [SpigotMC](https://www.spigotmc.org/resources/120743/)
2. Place the `.jar` file in your server's `plugins` folder
3. Restart your server
4. Edit the generated configuration files to customize the plugin
## 🌍 Supported Translations
| Language | Locale Code | Contributor | Version | Status |
|----------|-------------|-------------|---------|--------|
| English (Default) | `en_US.yml` | - | `latest` | ✅ Complete |
| Vietnamese | `vi_VN.yml` | - | `latest` | ✅ Complete |
| Chinese Simplified | `zh_CN.yml` | [SnowCutieOwO](https://github.com/SnowCutieOwO) | `latest` | ✅ Complete |
**Want to contribute a translation?** Fork the repository, create your locale file based on `en_US.yml`, and submit a pull request!
### Translation Guidelines
When contributing translations:
1. Use the `en_US.yml` file as a template
2. Maintain all placeholders (%variable%)
3. Keep formatting codes (like &e, &7)
4. Test your translation in-game if possible
## 📝 Commands & Permissions
🛠️ Commands
**Aliases:** `/ss`, `/spawner`, `/smartspawner`
| Command | Description | Permission |
|---------|-------------|------------|
| `/smartspawner reload` | Reload the plugin settings | `smartspawner.reload` |
| `/smartspawner give ` | Give a spawner to a player or yourself | `smartspawner.give` |
| `/smartspawner list` | Open the spawner list GUI for admin management | `smartspawner.list` |
| `/smartspawner hologram` | Toggle hologram display for spawners | `smartspawner.hologram` |
📜 Permissions
| Permission | Description | Default |
|------------|-------------|---------|
| `smartspawner.reload` | Allows reloading the plugin | OP |
| `smartspawner.give` | Allows giving spawners to yourself or other players | OP |
| `smartspawner.list` | Allows accessing the spawner list command | OP |
| `smartspawner.hologram` | Allows toggling hologram display for spawners | OP |
| `smartspawner.changetype` | Permits spawner type changes using spawn eggs | OP |
| `smartspawner.stack` | Allows stacking in the GUI or by right-click | true |
| `smartspawner.break` | Allows players to break spawners | true |
| `smartspawner.sellall` | Allows selling items in the spawner storage GUI | true |
## 📖 Documentation
Full documentation will be available soon. Stay tuned!
## 🤝 Contributing
SmartSpawner is an open-source project, and we welcome contributions from the community to help improve and expand its features. Whether you want to fix a bug, add a new feature, or improve documentation, your contributions are highly valued.
1. **Fork** the repository
2. **Create** a feature branch (`git checkout -b feature/amazing-feature`)
3. **Commit** your changes (`git commit -m 'Add some amazing feature'`)
4. **Push** to the branch (`git push origin feature/amazing-feature`)
5. **Open** a Pull Request
## 📢 Support & Community
Need help or found a bug? Feel free to:
- Join our [Discord Server](https://discord.gg/zrnyG4CuuT)
- Report bugs on [GitHub Issues](https://github.com/ptthanh02/Smart-Spawner-Plugin/issues)
- Check our [FAQ Section](https://github.com/ptthanh02/Smart-Spawner-Plugin/wiki/FAQ)
## 📄 License
This project is licensed under the **CC BY-NC-SA 4.0 License**. See the [LICENSE](LICENSE) file for more details.
## 📊 bStats Statistics
See real-time usage statistics on **[bStats](https://bstats.org/plugin/bukkit/SmartSpawner)**:
[](https://bstats.org/plugin/bukkit/SmartSpawner)
## 📊 Server Showcase
Are you using Smart Spawner on your server? Let us know to be featured here!