Skip to content

TogetherShop is a fork of Quickshop-Hikari, which allows Minecraft players to convert storage boxes such as barrels and chests, into interactive shops to buy and sell items with other players. This is a fork for me to play with and tweak; you almost certainly want the Quickshop-Community-Authored Upstream they are far smarter than I am.

License

Notifications You must be signed in to change notification settings

jk33v3rs/TogetherShop-Hikari

 
 

Repository files navigation

TogetherShop-Hikari, or, one man's attempt to see if he can figure out how to make that one plugin do a half-baked thing.

![JavaVersion] ![MinecraftVersion] ![Ver]

Introduction

TogetherShop Hikari is pretty much mostly Quickshop-Hikari, a Shop plugin that allows Minecraft players to easily sell and buy items, main difference being that I broke this version. In fact, all commands in QuickShop are not even needed for normal gameplay.

This version of QuickShop is a fork from (Ghost-chu/QuickShop-Hikari) which is a fork from PotatoCraft-Studio's version which itself is a fork from the Reremake of the original QuickShop.

QuickShop Hikari is maintained by the Quickshop community, at time of writing including Ghost-Chu along with a bit of a who's who of PaperMC economy plugin authors in 2024 (BOTH of them can you believe it??! XD ), and has the goal to modernize the core content of QuickShop and adapt it to the latest versions of Minecraft.

TogetherShop Hikari stands against that tradition by playing with buttons and dials mostly at random to see what happens.

If this version says it's working on a CI, I've either figured out how to trick the CI into issuing a false positive, or simply just outright faked it in MS Paint or something.

Note the below contact details are NOT for me -

They are for the talent (QS Community) whom you actually want to speak to... Although by this far into doing this bit, if youre still reading this there's something wrong in your brain and who knows what you want...

Community & Support

Discussions
Bug Tracker
Discord

Features

  • Easy to use
  • Toggleable Display Item on top of the chest.
  • NBT Data, Enchantment, Tool Damage, Potion, and Mob Egg support.
  • Unlimited chest support.
  • Blacklist support & bypass permissions.
  • Shops that buy and sell items at the same time (Using double chests).
  • Customizable permission checks.
  • UUID support.
  • Better shop protection.
  • i18n support for displayed Item names.
  • i18n support for displayed Enchantment names.
  • A cool item preview.
  • World/region protection plugins support.
  • ProtocolLib based Virtual Display Item support.
  • Powerful API.
  • Optimized performance.
  • MiniMessage syntax support.
  • H2 (local) or MySQL (remote) datasource support.
  • Supports custom inventory! Use the InventoryWrapper API.
  • Optimized for Paper, but also runs on Spigot (Though slower and with a more "hacky" approach).
  • Advanced Transaction System. Undo any Inventory/Economy operation with a shop when it failed to prevent duplications and exploits.
  • Per-shop permission management.
  • Shop benefits between shop owner and other players!
  • And much much more!

Downloads

Obtain the latest version from ci.codemc.io

Compatibility Modules

You can download optional modules here for compatibility with other plugins.

  • Stops clearlagg from deleting the Display Item on any Shop.
  • Prevents NCP's anti-cheat checks from triggering when creating a shop.
  • Allow the usage of a Player's Ender Chest as Shop inventory by using /quickshop echest.
  • Removes Shops that got deleted during a WorldEdit operation, to reduce "Ghost Shops".
  • Flag-based shop control.

Contribute

If you're a developer, you can contribute to the QuickShop source code! Just make a fork, install the Lombok plugin (if not done automatically), make your changes and create a pull request when you're done!
Please try to follow Google's Java Code Style and do not increase the Plugin version. Thank you!

Distributing forks

You're allowed to create your fork to share. No permission is needed.
Though it would be nice if you could pull-request your changes into this repository when they are good ones.

Compile and Debugging

To compile and debug QuickShop, please do the following steps:

  1. Make sure you're using Java 17 or 18. You can get the latest Java versions from the Adoptium project.
  2. Compile the main project without a signature by using mvn install -Pgithub with the GitHub Profile selected.
  3. Put the compiled jar into your Test-server's plugins folder, start the server and begin debugging!

To compile the QuickShop and debug it by yourself, please follow these steps:

  1. Make sure you're using Java17+ JDK in your PATH.
  2. Compile main-project without signature by using profile: mvn install -Pgithub with github profile selected.
  3. Start your server and go on.

bStats

QuickShop-Hikari collects certain statistic through bStats.
You may opt-out by setting disabled-metrics to true in the config.yml.

![bStatsImage]

License

![fossaStatusImageLarge]

Developer API

QuickShop-Hikari offers an API for you to use features such as retrieving active shops of a player.

Maven

<repositories>
    <repository>
        <id>codemc</id>
        <url>https://repo.codemc.io/repository/maven-public/</url>
    </repository>
</repositories>

<dependencies>
<!-- QuickShop Main Module -->
<dependency>
    <groupId>com.ghostchu</groupId>
    <artifactId>quickshop-bukkit</artifactId>
    <version>VERSION HERE</version>
    <scope>provided</scope>
    <classifier>shaded</classifier>
</dependency>
</dependencies>

Gradle

repositories {
    maven { url = "https://repo.codemc.io/repository/maven-public/" }
}

dependencies {
  compileOnly "com.ghostchu:quickshop-bukkit:VERSION HERE"
}

Hook into the API

public class MyPlugin extends JavaPlugin {

    @Override
    public void onEnable() {
        QuickShopAPI api = QuickShopAPI.getInstance();
        QuickShop instance = QuickShopAPI.getPluginInstance();
        QuickShop anotherWayToGetInstance = QuickShop.getInstance();
    }

}

Repository Activity

analytics

About

TogetherShop is a fork of Quickshop-Hikari, which allows Minecraft players to convert storage boxes such as barrels and chests, into interactive shops to buy and sell items with other players. This is a fork for me to play with and tweak; you almost certainly want the Quickshop-Community-Authored Upstream they are far smarter than I am.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Java 100.0%