![Logo JK Studios](https://cdn.modrinth.com/data/cached_images/d3c3aa639ec25b45f4c942614d4b7ef27fdda3da.png) # JakubSasinkaCore [![Read the Documentation](https://raw.githubusercontent.com/intergrav/devins-badges/0a3449fd26bf1375d2c5c26f096c8f30aa358766/assets/cozy/social/github-plural_vector.svg)](https://github.com/Vir545/JakubSasinkaCore) [![Translate on Crowdin](https://raw.githubusercontent.com/intergrav/devins-badges/0a3449fd26bf1375d2c5c26f096c8f30aa358766/assets/cozy/translate/crowdin_vector.svg)](https://crowdin.com/project/jakubsasinkacore) [![Discord Server](https://raw.githubusercontent.com/intergrav/devins-badges/0a3449fd26bf1375d2c5c26f096c8f30aa358766/assets/cozy/social/discord-plural_vector.svg)](https://discord.gg/nwVTHexjJc) [![Built with Java 21](https://raw.githubusercontent.com/intergrav/devins-badges/0a3449fd26bf1375d2c5c26f096c8f30aa358766/assets/cozy/built-with/java21_vector.svg)](https://adoptium.net/temurin/releases/?version=21) [![Available on Modrinth](https://raw.githubusercontent.com/intergrav/devins-badges/0a3449fd26bf1375d2c5c26f096c8f30aa358766/assets/cozy/available/modrinth_vector.svg)](https://modrinth.com/plugin/jakubsasinkacore) [![Available on Hangar](https://raw.githubusercontent.com/intergrav/devins-badges/0a3449fd26bf1375d2c5c26f096c8f30aa358766/assets/cozy/available/hangar_vector.svg)]() [![Read the Changelog](https://raw.githubusercontent.com/intergrav/devins-badges/0a3449fd26bf1375d2c5c26f096c8f30aa358766/assets/cozy/documentation/changelog_vector.svg)](https://modrinth.com/plugin/jakubsasinkacore/changelog) [![Check out the Gallery](https://raw.githubusercontent.com/intergrav/devins-badges/0a3449fd26bf1375d2c5c26f096c8f30aa358766/assets/cozy/documentation/modrinth-gallery_vector.svg)](https://modrinth.com/plugin/jakubsasinkacore/gallery) [![Available for Bukkit](https://raw.githubusercontent.com/intergrav/devins-badges/0a3449fd26bf1375d2c5c26f096c8f30aa358766/assets/cozy/supported/bukkit_vector.svg)](https://getbukkit.org/download/craftbukkit) [![Available for Spigot](https://raw.githubusercontent.com/intergrav/devins-badges/0a3449fd26bf1375d2c5c26f096c8f30aa358766/assets/cozy/supported/spigot_vector.svg)](https://getbukkit.org/download/spigot) [![Available for Paper](https://raw.githubusercontent.com/intergrav/devins-badges/0a3449fd26bf1375d2c5c26f096c8f30aa358766/assets/cozy/supported/paper_vector.svg)](https://papermc.io/downloads/paper) [![Available for Purpur](https://raw.githubusercontent.com/intergrav/devins-badges/0a3449fd26bf1375d2c5c26f096c8f30aa358766/assets/cozy/supported/purpur_vector.svg)](https://purpurmc.org/download/purpur) The JakubSasinkaCore plugin is the core for minigames such as [Fishing +](https://modrinth.com/plugin/fishing++), SpeedRun, Archery and future more. You need the [PlaceholderAPI](https://modrinth.com/plugin/placeholderapi) if you want placeholders and [DecentHolograms](https://modrinth.com/plugin/decentholograms) if you want to generate a hologram template on your server ## 💎 Key Features - ✨ Tab Completer - Tab completion works for all commands. - A custom permissions system has been added; see below for more details. ### 👤 Player Management - ```/manage [player]``` Data management for the Fishing, SpeedRun, and Archery mini-games includes clearing all mini-game data _([Gallery](https://modrinth.com/plugin/jakubsasinkacore/gallery):[Manage Home Page])_, clearing a single player's data _([Gallery](https://modrinth.com/plugin/jakubsasinkacore/gallery):[Manage Player Home Page])_, and viewing a player's overall statistics—such as which items they caught and how many. ```player``` is used to specify which user to open. _([Gallery](https://modrinth.com/plugin/jakubsasinkacore/gallery):[Manage Player Statistics])_. It also features a dynamic Players page where you can see all players who have earned at least 1 point in the mini-games, with automatic pagination and sorting by mini-game or alphabetically. _([Gallery](https://modrinth.com/plugin/jakubsasinkacore/gallery):[Manage Players])_ ### 🛡️ Admin Commands - ```/jsc``` This opens the plugin interface, where you can view all the plugins currently installed on the server and their versions. (e.g., if you have JakubSasinkaCore and one other plugin, only two will be listed there.) _([Gallery](https://modrinth.com/plugin/jakubsasinkacore/gallery):[Plugins Menu Main])_ - ```/jsc ``` Currently, you can create a hologram template, test whether the text works correctly in a given language, and reset the API. - ```/jsc api``` or ```/jscapi``` Re-registers the placeholder in PAPI. - ```/jsc holo [name]``` The ```name``` attribute is used for a custom placeholder name. Hologram template _([Gallery](https://modrinth.com/plugin/jakubsasinkacore/gallery):[Hologram Template Main])_ - ```/jsc language ``` Just enter the ```name``` from the lang.yml file, and either the text or an error message will appear. (e.g., ```/jsc language no_permission```) - ```/jsc placeholders``` or ```/jscp``` List of placeholders - ```/jsc reload ``` or ```/jscreload ``` Reload the entire plugin or part of it, depending on the 'command' argument ## 🔖 Language System Currently, only the cs_CZ.yml and en_US.yml files are available. However, if you want to change the language, simply set `settings.Language` to your preferred language in the config.yml file. If you are using multiple plugins, they share a single centralized language system in the Core plugin. Therefore, language files are not included in individual plugins. However, the other lang files are currently on [GitHub](https://github.com/Vir545/JakubSasinkaCore/tree/main/src/main/resources/lang). ## ⚙️ Configuration - The coordinates for the mini-games are set in the configuration file in Core. To apply the changes, you need to run '/jsc reload ' in the "config.yml" file.

Click to view config.yml

# * Config version 1.0.0 # * Minecraft versions: # * Build: 1.21.11 # * Tested: 26.1.2, 1.21.11-1.21.1 # ? JakubSasinkaCore settings: name: "X" version: "1.0.0" supported: "1.21.x" created: "1.21.x" build: "B100" Language: "cs_CZ" Database: # Database type: none (Minecraft scoreboard), SQLite type: "SQLite" host: "localhost" # It's not working right now... port: 3306 # It's not working right now... database: "database" # It's not working right now... username: "root" # It's not working right now... password: "password" # It's not working right now... Admin: Permissions: # If the value is "true", the permission settings from the permissions.yml file are used instead of the default permissions. custom-permissions: false manage: # Enable or disable the "specific only" mode for the /manage command restriction: false # You can add specific users who have permissions to use /manage the system. (They must have either the "OP" or "jakubsasinkacore.admin" permission.) # players: # - "Admin" # - "Mod" Minigames: Lobby: world: spawn loc: "0,250,0" Fishing: prefix: "§e[§b?§e] " Locations: Location1: pirate: "39,222,-37" world: spawn pos1: "23,230,-9" pos2: "83,218,-65" Loc2: pirate: "39,222,-37" world: spawn pos1: "23,230,-9" pos2: "83,218,-65" SpeedRun: Locations: Location1: world: spawn pos1: "23,223,-50" pos2: "-23,227,-23" Archery: Locations: Location1: world: spawn pos1: "-48,222,16" pos2: "-26,226,17"

## 🔑 Permissions Compatible with - [LuckPerms](https://modrinth.com/plugin/luckperms), _compatibility with other permission management plugins is not guaranteed._ - This library also offers its own custom permissions system, which consists of groups of commands to which you can assign existing permissions from the plugin. However, for this to work, it must be enabled in the config: 'Admin.Permissions.custom-permissions: true' - In addition, this library offers player restrictions for the '/manage' command. Based on the admin names specified in the config, only those users will have access to '/manage', but they must still have the appropriate permissions. In the config, this is set to 'Admin.Permissions.manage.restriction: true', and then you simply need to add the relevant permissions to 'Admin. Permissions.manage.players'. A clear example is provided directly in config.yml

Click to view permissions.yml

# * Config version 1.0.0 # * Minecraft versions: # * Build: 1.21.11 # * Tested: 26.2, 26.1.2, 1.21.11-1.21.1 # ? JakubSasinkaCore - Custom Permissions # List of variable permissions: # jakubsasinkacore.admin, jakubsasinkacore.jsc, jakubsasinkacore.api, jakubsasinkacore.reload, jakubsasinkacore.holograms, # jakubsasinkacore.placeholders, jakubsasinkacore.connection, jakubsasinkacore.manage, jakubsasinkacore.user # Example: JakubSasinkaCore: Commands_Reload: - "jakubsasinkacore.admin" - "jakubsasinkacore.reload" Commands_API: - "jakubsasinkacore.admin" - "jakubsasinkacore.api" Commands_Holograms: - "jakubsasinkacore.admin" - "jakubsasinkacore.holograms" Commands_Placeholders: - "jakubsasinkacore.admin" - "jakubsasinkacore.placeholders" Connection: - "jakubsasinkacore.admin" - "jakubsasinkacore.connection" Manage_All: - "jakubsasinkacore.admin" - "jakubsasinkacore.manage" JSC_Plugins: - "jakubsasinkacore.admin" - "jakubsasinkacore.jsc"

```jakubsasinkacore.* – Access to all commands (default: OP) jakubsasinkacore.admin – Access to all commands (default: OP) jakubsasinkacore.jsc - Access to '/jsc' jakubsasinkacore.api - Access to '/jsc api' or '/jscapi' jakubsasinkacore.reload - Access to '/jsc api' or '/jscreload' or '/jscr' jakubsasinkacore.area - Access to '/jsc' or '/jscarea' jakubsasinkacore.holograms - Access to '/jsc' jakubsasinkacore.placeholders - Access to '/jsc' or '/jscp' jakubsasinkacore.connection - Access to '/connection' jakubsasinkacore.manage - Access to '/jsc' jakubsasinkacore.user - Access to user common commands``` ## 📌 PAPI Placeholders You need to have [PlaceholderAPI](https://modrinth.com/plugin/placeholderapi) on your server.

Click to view all Placeholders

%JSC% // Returns the text "Registered"; otherwise, there is an error somewhere. %JSC_time% // Last updated %JSC_Fishing_me% %JSC_Fishing_me_Points_score% %JSC_Fishing_me_Coins_score% %JSC_Fishing_me_CaughtFish_score% %JSC_Fishing_me_Luck_score% %JSC_Fishing_me_Lure_score% %JSC_Fishing_me_TIME_score% %JSC_Fishing_me_AFK_score% %JSC_Fishing_me_Rank_score% %JSC_Fishing_me_RankP_score% %JSC_Fishing_me_RankZ_score% %JSC_Fishing__name% %JSC_Fishing__Points_score% %JSC_Fishing__Coins_score% %JSC_Fishing__CaughtFish_score% %JSC_Fishing__Lure_score% %JSC_Fishing__Luck_score% %JSC_Fishing__TIME_score% %JSC_Fishing__AFK_score% %JSC_Fishing__Rank_score% %JSC_Fishing__RankP_score% %JSC_Fishing__RankZ_score% %JSC_Fishing_% %JSC_Fishing__Points_score% %JSC_Fishing__Coins_score% %JSC_Fishing__CaughtFish_score% %JSC_Fishing__Lure_score% %JSC_Fishing__Luck_score% %JSC_Fishing__TIME_score% %JSC_Fishing__AFK_score% %JSC_Fishing__Rank_score% %JSC_Fishing__RankP_score% %JSC_Fishing__RankZ_score% %JSC_SpeedRun_me% %JSC_SpeedRun_me_TotalMeters_score% %JSC_SpeedRun_me_m_score% %JSC_SpeedRun_me_km_score% %JSC_SpeedRun__name% %JSC_SpeedRun__score% %JSC_SpeedRun__m_score% %JSC_SpeedRun__km_score% %JSC_SpeedRun_% %JSC_SpeedRun__TotalMeters_score% %JSC_SpeedRun__m_score% %JSC_SpeedRun__km_score% %JSC_Archery_me% %JSC_SpeedRun_me_Coins_score% %JSC_SpeedRun_me_Hit_score% %JSC_Archery__name% %JSC_Archery__Coins_score% %JSC_Archery__Hit_score% %JSC_Archery_% %JSC_Archery__Coins_score% %JSC_Archery__Hit_score%

If you also want extra placeholders for residences and the economy, you'll need **[Residence](https://www.spigotmc.org/resources/residence-1-7-10-up-to-1-21.11480/)** and **[Vault](https://www.spigotmc.org/resources/vault.34315/)**.

Click to view extra Placeholders

%JSC-Residence% %JSC-Residence_time% %JSC-Residence_top<1-10>% %JSC-Residence_top<1-10>_name% %JSC-Residence_top<1-10>_price% %JSC-Residence_top<1-10>_SellPrice% %JSC-Residence_top<1-10>_SellPriceMult% %JSC-Residence_top<1-10>_size% %JSC-Residence_top<1-10>_TPLoc% %JSC-Residence_top<1-10>_main% %JSC-Economy% %JSC-Economy_time% %JSC-Economy_total% %JSC-Economy_top<1-10>% %JSC-Economy_top<1-10>_total% %JSC-Economy_top<1-10>_money%

## 🔧 Compatibility Version: Minecraft 26.2, 26.1.x, 1.21.11-1.21.1 Major Version: Minecraft 1.21.11 Server: Paper, Spigot, Purpur, Bukkit ## 📩 Contact - If you have any problems with plugin. Thanks for downloading! Discord: .vir.3665 - https://discord.gg/nwVTHexjJc ## 📈 Metrics - BStats [![BStats Metrics](https://bstats.org/signatures/bukkit/JakubSasinkaCore.svg)](https://bstats.org/plugin/bukkit/JakubSasinkaCore) ![Logo JK Studios](https://cdn.modrinth.com/data/cached_images/d3c3aa639ec25b45f4c942614d4b7ef27fdda3da.png)

pan_krumpac