Skip to content

Latest commit

 

History

History
199 lines (157 loc) · 8.51 KB

README.md

File metadata and controls

199 lines (157 loc) · 8.51 KB

CyberAPI

JitPack Build Status GitHub Actions Build Status

The new and improved CyberAPI, version 3, is here! This is a library used for most of CyberedCake's plugins and can be used by you for free! It adds additional features that Spigot and Bungeecord do not have and makes existing stuff easier.

You can view the to-do list and future plans by clicking here

How to install and use

INSTALL FOR SPIGOT (click to expand/shrink)

Installation - Spigot

(It is recommended that you use PaperSpigot instead of Spigot, but Spigot is still supported and PaperSpigot works on the 'spigot' portion of the library!)

INSTALL WITH GRADLE [RECOMMENDED] (click to expand/shrink)

Step 1) Include the below code in your build.gradle "repositories" section.

	repositories {
		maven { url 'https://repo.cybercake.net/repository/maven-public/' } 
	}

Step 2) Include the below code in your build.gradle "dependencies" and replace "LATEST BUILD" with the latest build that you see here:
Note: Including the "common" package is a REQUIREMENT! Without this package, the library will fail to initialize.

	dependencies {
	        implementation 'net.cybercake.cyberapi:spigot:LATEST BUILD'
		implementation 'net.cybercake.cyberapi:common:LATEST BUILD'
	}

Step 3) Reload your gradle project and follow the usage instructions below.


INSTALL WITH MAVEN (click to expand/shrink)

Step 1) Include the below code in your pom.xml "repositories" section.

    <repositories>
    	<repository>
            <id>cybercake.net</id>
            <url>https://repo.cybercake.net/repository/maven-public/</url>
	 </repository>
    </repositories>

Step 2) Include the below code in your build.gradle "dependencies" and replace "LATEST BUILD" with the latest build that you see here:
Note: Including the "common" package is a REQUIREMENT! Without this package, the library will fail to initialize.

    <dependencies>
    	<dependency>
            <groupId>net.cybercake.cyberapi</groupId>
            <artifactId>spigot</artifactId>
            <version>LATEST BUILD</version>
	 </dependency>
	 <dependency>
            <groupId>net.cybercake.cyberapi</groupId>
            <artifactId>common</artifactId>
            <version>LATEST BUILD</version>
	 </dependency>
    </dependencies>

Step 3) Reload your maven project and follow the usage instructions below.


How to use - Spigot

To use CyberAPI, write this in your main onEnable method:

import net.cybercake.cyberapi.spigot.CyberAPI;
import net.cybercake.cyberapi.common.builders.settings.Settings;

public class MainClass extends CyberAPI { // you must extend CyberAPI instead of JavaPlugin

    @Override
    public void onEnable() {
        startCyberAPI( // this method will start CyberAPI and is **required** to be the first thing in your onEnable() method
                Settings.builder()
                        // put your settings here, usually in the form of .<setting>(<value>)

			// include your main package in the build!
			// for example: if your Main class is in the package "net.cybercake.testplugin.Main", then put "net.cybercake.testplugin"
                        .build(*main package*) // build once you have changed the settings you want
        );
        
        // now you have access to everything CyberAPI!
        // view the docs here: https://docs.spigot.cybercake.net/
    }

}
INSTALL FOR BUNGEECORD (click to expand/shrink)

Installation - Bungeecord

(It is recommended that you use Waterfall instead of Bungeecord, but Bungeecord is still supported and Waterfall works on the 'bungee' portion of the library!)

INSTALL WITH GRADLE [RECOMMENDED] (click to expand/shrink)

Step 1) Include the below code in your build.gradle "repositories" section.

	repositories {
		maven { url 'https://repo.cybercake.net/repository/maven-public/' } 
	}

Step 2) Include the below code in your build.gradle "dependencies" and replace "LATEST BUILD" with the latest build that you see here:
Note: Including the "common" package is a REQUIREMENT! Without this package, the library will fail to initialize.

	dependencies {
	        implementation 'net.cybercake.cyberapi:bungee:LATEST BUILD'
		implementation 'net.cybercake.cyberapi:common:LATEST BUILD'
	}

Step 3) Reload your gradle project and follow the usage instructions below.


INSTALL WITH MAVEN (click to expand/shrink)

Step 1) Include the below code in your pom.xml "repositories" section.

    <repositories>
    	<repository>
            <id>cybercake.net</id>
            <url>https://repo.cybercake.net/repository/maven-public/</url>
	 </repository>
    </repositories>

Step 2) Include the below code in your build.gradle "dependencies" and replace "LATEST BUILD" with the latest build that you see here:
Note: Including the "common" package is a REQUIREMENT! Without this package, the library will fail to initialize.

    <dependencies>
    	<dependency>
            <groupId>net.cybercake.cyberapi</groupId>
            <artifactId>bungee</artifactId>
            <version>LATEST BUILD</version>
	 </dependency>
    	<dependency>
            <groupId>net.cybercake.cyberapi</groupId>
            <artifactId>common</artifactId>
            <version>LATEST BUILD</version>
	 </dependency>
    </dependencies>

Step 3) Reload your maven project and follow the usage instructions below.


How to use - Bungeecord

To use CyberAPI, write this in your main onEnable method:

import net.cybercake.cyberapi.bungee.CyberAPI;
import net.cybercake.cyberapi.common.builders.settings.Settings;

public class MainClass extends CyberAPI { // you must extend CyberAPI instead of Plugin

    @Override
    public void onEnable() {
        startCyberAPI( // this method will start CyberAPI and is **required** to be the first thing in your onEnable() method
                Settings.builder()
                        // put your settings here, usually in the form of .<setting>(<value>)

			// include your main package in the build!
			// for example: if your Main class is in the package "net.cybercake.testplugin.Main", then put "net.cybercake.testplugin"
                        .build(*main package*) // build once you have changed the settings you want
        );

        // now you have access to everything CyberAPI!
        // view the docs here: https://docs.bungee.cybercake.net/
    }

}