Oraxen Transparent Blocks

Oraxen Transparent Blocks

This is an addon to the Premium plugin Oraxen. It adds the ability to use custom models that are transparent or don't fill an entire block without render issues.

Getting Started
These instructions will get you a copy of the project up and running on your local machine for development and testing purposes. See deployment for notes on how to deploy the project on a live system.

Prerequisites
You must have Oraxen, WorldEdit, and WorldGuard installed on your server to use this plugin.

Installing
Place the plugin jar file in your servers plugins directory.

Adding Transparent Block Mechanic to Oraxen
Add the following to mechanics.yml in your Oraxen plugin folder.

transparent_block:
  enabled: true

Configuring Blocks
Create a custom item/block using Oraxen and give your item/block the transpatent_block mechanic.

Example:

transparent_block:
  displayname: '&7Transparent Block'
  material: DIAMOND
  Pack:
    generate_model: false
    model: transparent_block
  Mechanics:
    transparent_block:
      custom_variation: 1
      armorstand_visible: false
      armorstand_small: false
      block_gravity: false
      break_sound: BLOCK_GLASS_BREAK
      drop:
        loots:
          - {oraxen_item: transparent_block, probability: 1.0, max_amount: 1}

Note: In order to test the block above download this pack and place the contents in your Oraxen/pack directory. If you have any current items/blocks using the Diamond as its base material, this will override those, be sure to create a backup prior.

Block Models
When creating custom models to use with this plugin, you will need to modify the armorstand's helmet display settings to your likings. This is how the block will show in-game.

Developers
Although not very extensive, this plugin call's the following custom events for developers to use;

* OraxenTransparentBlockInteractEvent
* OraxenTransparentBlockPrePlaceEvent
* OraxenTransparentBlockPlaceEvent
* OraxenTransparentBlockPreBreakEvent
* OraxenTransparentBlockBreakEvent

Adding OraxenTransparentBlocks To Your Plugin

<repository>
    <id>jitpack.io</id>
    <url>https://jitpack.io</url>
</repository>
<dependency>
    <groupId>com.github.playajames419</groupId>
    <artifactId>OraxenTransparentBlocks</artifactId>
    <version>1.1</version>
</dependency>

License
This project is licensed under the GNU GPLv3 License