lauriichan / justlootit

Unique and refreshable loot containers and entities for everyone. (Spigot plugin)

JustLootIt

Unique and refreshable loot containers and entities for everyone.

Report Bug · Request Feature

Table of Contents

1. About The Project
   • Built With
2. Getting Started
   • Installation
   • Container and entity conversion
   • JustLootIt as Maven Dependency
3. Roadmap
4. Contributing
5. License
6. Contact

About The Project

JustLootIt is an alternative plugin to Lootin (Spigot / Github).

The main reason for the existence of JustLootIt is that in 2023 Lootin was no longer maintained for a long time which then sparked this project as an alternative. However what I wanted to achieve is not just an alternative but more than that and I think I've done a pretty good job with it. JustLootIt has the same functionality as Lootin and even more, it allows for refreshable containers (blocks and entities) and even linked containers (between multiple blocks and entities) and can be customized in many ways. This allows players to loot a container more than one time if the server owner wants that to happen and even more is planned in the future.

Built With

• Spigot
• LayLib
• SpigotPluginBase
• BetterInputs (optional)

Getting Started

To get a local copy you only need to download it from Spigot or if you want to get the Source just fork this repository or download it as zip.

Installation

To install the plugin you only need to do following steps:

1. Download the plugin
2. Put it into your server's plugin folder
3. Start or reload your server
4. Enjoy the plugin!

Container and entity conversion

If you want to use JustLootIt in an already existing world that's no problem as well!
The plugin has a feature that allows you to convert vanilla loot containers and entities even if JustLootIt was installed at a later point in time, however it's not perfect and already looted containers might not be converted.
If you came from Lootin then that's also no problem, it's the same process in this case, JustLootIt can just convert Lootin containers and entities to JustLootIt containers and entities.
Please note: that in both cases the process is not revertable, so please create a backup of your world if you are not sure yet if you want to keep using JustLootIt in favour of vanilla or Lootin loot containers and entities.

Steps to convert vanilla or Lootin containers or entities:

1. Start your server
2. Type /justlootit convert into your console
3. Follow the setup process
4. Done!

The server will now restart (you may need to manually start the server if you did not setup a restart script in the spigot.yml) and do the conversion after which it will restart again if the process modified the worlds.

JustLootIt as Maven Dependency

To get started with maven you first need to setup your environment to get access to the api maven package. To do that simply go into your .m2 folder which can be found at %appData%\..\..\.m2 (Open Run on Windows and just paste the path into there and click Ok). Afterwards if the file doesn't exist yet create the file settings.xml in the folder. Then put following stuff into the file:

<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
	xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0
                      http://maven.apache.org/xsd/settings-1.0.0.xsd">

	<activeProfiles>
		<activeProfile>github</activeProfile>
	</activeProfiles>

	<profiles>
		<profile>
			<id>github</id>
			<repositories>
				<repository>
					<id>central</id>
					<url>https://repo1.maven.org/maven2</url>
				</repository>
				<repository>
					<id>github0</id>
					<url>https://maven.pkg.github.com/Lauriichan/*</url>
					<snapshots>
						<enabled>true</enabled>
					</snapshots>
				</repository>
			</repositories>
		</profile>
	</profiles>

	<servers>
		<server>
			<id>github0</id>
			<username>YOUR_GITHUB_USERNAME</username>
			<password>A_GITHUB_TOKEN</password>
		</server>
	</servers>
</settings>

Now replace YOUR_GITHUB_USERNAME with your github username.
Then go to your Github account settings and scroll down until you see Developer settings.
Go into the Developer settings and then click on Personal access tokens.
Once you are there click on the Generate new token button.
I would recommend you to enter Maven packages into the Note field and set the epiration to No expiration.
Then you need to enable repo:status and read:packages.
Once you enabled those click on Generate Token at the bottom.
Now github should show you the token, simply copy the token and replace A_GITHUB_TOKEN with it.
The token can be used for multiple servers so if you want to have access to another repository hosted on github simply copy the github0 repository replace MrNemo64 with the authors' name and copy the github0 server. Be sure to rename the repository and server id to for example github1 or something similar (they have to match up).

Once this is setup you can simply add the dependency like this in your pom.xml:

<dependency>
  <groupId>me.lauriichan.spigot.justlootit</groupId>
  <artifactId>justlootit-core</artifactId>
  <version>1.0.0</version>
</dependency>

You can get the latest version here (Comming soon)

Roadmap

See the open issues for a list of proposed features (and known issues).

Contributing

Contributions are what make the open source community such an amazing place to be learn, inspire, and create. Any contributions you make are greatly appreciated.

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

License

Distributed under the GPLv3 License. See LICENSE for more information.

Contact

Discord Link: https://discord.gg/m9vjsj6ScJ

Project Link: https://github.com/Lauriichan/JustLootIt