You can find the source code for CMI-API, and download it as a .jar file from github.com/Zrips/CMI-API
Player/User Object
Most things related to the player can be accessed through users object
CMIUser user = CMI.getInstance().getPlayerManager().getUser(player);
This can return NULL in some rare situations, so perform NPE check.
You can get the offline player object from this one by using
Player player = user.getPlayer();
This can be used to access some of the player’s data information even if he is offline. Keep in mind that this actually loads players’ information and is highly not recommended to be used to load hundreds or even thousands of players with this method as this will undoubtedly cause some strain on the server. You can tho update some of the player data but you will need to save it by (ONLY if the player is offline) using
player.saveData();
or by using
CMI.getInstance().save(player);
This is more safe approach as the player object will be checked for appropriate save.
Holograms
To create new custom hologram we will need center location and some unique name and center location
CMIHologram holo = new CMIHologram("TestHologram", center);
Next lets set some lines for it with
holo.setLines(Arrays.asList("Line 1","Line 2"));
Lets add new hologram to cache. This is essential step to inform plugin that we have new hologram which should be included into cache. This will perform extra actions needed for hologram to work properly.
CMI.getInstance().getHologramManager().addHologram(holo);
And finally, you can update it for every player who is near it to show it.
Attention! This will create a temporary hologram which will not be persistent over server restart. use option provided belove to make it persistent.
holo.update();
Final code should look something like
CMIHologram holo = new CMIHologram("TestHologram", center);
holo.setLines(Arrays.asList("Line 1","Line 2"));
CMI.getInstance().getHologramManager().addHologram(holo);
holo.update();
Attention! If you want to save hologram file, use this. By default, hologram will be visible only until you remove it or server restarts.
holo.makePersistent();
If you want to save new information into file
CMI.getInstance().getHologramManager().save();
If you want to hide hologram temporary, then you can use
holo.hide();
This will only hide it until player reenters hologram area.
If you want to disable hologram entirely, then use
holo.disable();
Enabling hologram is as easy as it gets
holo.enable();
In case you have updated hologram lines and want then to be displayed. Use
holo.refresh();
Changing hologram location can be done with
holo.setLoc(center);
After which you will need to refresh hologram
And if you want to remove hologram, use
holo.remove();
Managers
Quite a few things can be accessed through appropriate managers. They all can be accessed through the basic method
CMI.getInstance().get[managerName]();
For example, to access the portal manager use
CMI.getInstance().getPortalManager();
Worth
// Item stack used to get worth
ItemStack item;
WorthItem worth = CMI.getInstance().getWorthManager().getWorth(item);
if (worth == null){
// Worthless item so we can return null or 0D, whatever is needed in your case
return null;
}
// Buy price used in exploit detection
Double buyPrice = worth.getBuyPrice();
// Sell price defines actual worth of the file
Double sellPrice = worth.getSellPrice();
// Item of which worth value we are getting
ItemStack item;
// Worth object
WorthItem worth = CMI.getInstance().getWorthManager().getWorth(item);
if (worth == null){
// If its null then lets create new one
worth = new WorthItem(item);
// Adding worth to cache
CMI.getInstance().getWorthManager().addWorth(worth);
}
// Changing prices
worth.setBuyPrice(2D);
worth.setSellPrice(1D);
// Lets update values in save file
CMI.getInstance().getWorthManager().updatePriceInFile(worth);
Custom Events
CMIAfkEnterEvent – Fired when player enters AFK mode.
CMIAfkKickEvent – Fired when player should be kicked from server after being AFK.
CMIAfkLeaveEvent – Fired when players leaves AFK mode.
CMIAnvilItemRenameEvent – Fired on item rename in anvil.
CMIAnvilItemRepairEvent – Fired on item repair action with anvil.
CMIArmorChangeEvent – Fired when player changes items in armor slots.
CMIBackpackOpenEvent – Fired on backpack open
CMIBossBarHideEvent – Fired when CMI boss bar should be hidden. Can be canceled.
CMIChunkChangeEvent – Fired when player changes chunk.
CMIGuiCloseEvent – Fired when player closed CMI GUI.
CMIEventCommandEvent – Fired on event command
CMIIpBanEvent – Fired when IP gets ban.
CMIIpUnBanEvent – Fired when IP gets unban.
CMIPlayerBanEvent – Fired when player gets ban.
CMIPlayerUnBanEvent – Fired when player gets unban.
CMIPlayerFakeEntityInteractEvent – Fired when player interacts with fake entity, in most cases this will be hologram button interaction.
CMIPlayerNickNameChangeEvent – Fired on player nickname change
CMIPlayerSitEvent – Fired on player sit action
CMIPlayerTeleportEvent – Fired before player teleportation. Includes possible safe location and reason why it could be unsafe. Provides source of teleportation.
CMIPlayerTeleportRequestEvent – Fired after player teleportation.
CMIPlayerJailEvent – Fired on player jail
CMIPlayerUnjailEvent – Fired on player unjail
CMIPlayerVanishEvent – Fired when player enters vanish event.
CMIPlayerUnVanishEvent – Fired when player exits vanish event.
CMIPlayerWarnEvent – Fired when player gets a warning
CMIPlayerWarpEvent – Fired before warping player to target location
CMIPortalCreateEvent – Fired on nether portal creation event.
CMIPortalUseEvent – Fired on CMI portal use event.
CMIPvEStartEventAsync – Fired on pve start
CMIPvEEndEventAsync – Fired on pve end
CMIPvPStartEventAsync – Fired on pvpstart event.
CMIPvPEndEventAsync– Fired on pvpend event.
CMISelectionEvent – Fired on selection
CMISelectionVisualizationEvent – Fired before selection visualization starts showing. Can be canceled.
CMIUserBalanceChangeEvent – Fired on user balance change, if CMI Economy is used. Change types include: setBalance, Withdraw, Deposit.
CMIPlayerItemsSellEvent – Fired on sell item action with command directly or when closing sell GUI