![[API] RaycastAPI | Create guns, get towards entity/block](https://www.spigotmc.org/data/resource_icons/77/77541.jpg?1587142739){kind=icon}
![[IMG]](http://proxy.spigotmc.org/e15b37093c23fd00d812a289641c51b0913d8340?url=https%3A%2F%2Floisduplain.fr%2Fstockage%2Fspigotmc%2Fraycast%2FSpigotMC-Title.png)
RaycastAPI is the unique API on SpigotMC that allows you to creates raycast.
You can use it to make guns, tools. It can be use to get the towards entity/block.
![[IMG]](http://proxy.spigotmc.org/fd8748ab508559f38432d72a7bd0fe10d4c2eec1?url=https%3A%2F%2Floisduplain.fr%2Fstockage%2Fspigotmc%2Fraycast%2Fexamples.png)
RaycastAPI is able to say you if you hurt something or no.
![[IMG]](http://proxy.spigotmc.org/4169bcdeee36264b77566c0369a8b61a76d04760?url=https%3A%2F%2Floisduplain.fr%2Fstockage%2Fspigotmc%2Fraycast%2Fhurt-nothing.gif)
------------------------------------------------------------------------------------
RaycastAPI can detect entity collision.
![[IMG]](http://proxy.spigotmc.org/a8e017cf0a4eb84d4510856decc337848f8dc105?url=https%3A%2F%2Floisduplain.fr%2Fstockage%2Fspigotmc%2Fraycast%2Fhurt-entity.gif)
------------------------------------------------------------------------------------
RaycastAPI can detect block collision.
![[IMG]](http://proxy.spigotmc.org/9dbeb69fcae17f41835b9afb473a57c013629b01?url=https%3A%2F%2Floisduplain.fr%2Fstockage%2Fspigotmc%2Fraycast%2Fhurt-block.gif)
------------------------------------------------------------------------------------
RaycastAPI can passthrough desired blocks.
![[IMG]](http://proxy.spigotmc.org/51f1fb5e802737d884b361ff0566997a77367611?url=https%3A%2F%2Floisduplain.fr%2Fstockage%2Fspigotmc%2Fraycast%2Fpassthrough.gif)
Example code:
Code (Java):
@EventHandler
public void whenClick ( PlayerInteractEvent e ) {
Player player = e. getPlayer ( ) ;
ItemStack i = e. getPlayer ( ) . getItemInHand ( ) ;
if ( i == null || i. getType ( ) == Material. AIR )
return ;
if ( e. getAction ( ) == Action . LEFT_CLICK_AIR && i. hasItemMeta ( ) && i. getItemMeta ( ) . hasDisplayName ( ) && i. getItemMeta ( ) . getDisplayName ( ) . equals ( "gun" ) ) {
Raycast raycast = new Raycast ( e. getPlayer ( ) . getEyeLocation ( ) , 100 ) ;
raycast. addPassthroughMaterial ( Material. LEAVES ) ;
raycast. setOwner ( player ) ;
raycast. setShowRayCast ( true ) ;
if ( raycast. compute ( RaycastType. ENTITY_AND_BLOCK ) ) {
player. sendMessage ( "§aRaycast hurt something" ) ;
Location hurtLocation = raycast. getHurtLocation ( ) ;
player. sendMessage ( "§cRaycast hurt " + ( ( raycast. getHurtBlock ( ) != null ) ? "a block " : "an entity" ) + " at X:" + hurtLocation. getBlockX ( ) + " Y: " + hurtLocation. getBlockY ( ) + " Z:" + hurtLocation. getBlockZ ( ) ) ;
} else {
player. sendMessage ( "§6Raycast hurt nothing" ) ;
}
e. setCancelled ( true ) ;
}
}
public void whenClick ( PlayerInteractEvent e ) {
Player player = e. getPlayer ( ) ;
ItemStack i = e. getPlayer ( ) . getItemInHand ( ) ;
if ( i == null || i. getType ( ) == Material. AIR )
return ;
if ( e. getAction ( ) == Action . LEFT_CLICK_AIR && i. hasItemMeta ( ) && i. getItemMeta ( ) . hasDisplayName ( ) && i. getItemMeta ( ) . getDisplayName ( ) . equals ( "gun" ) ) {
Raycast raycast = new Raycast ( e. getPlayer ( ) . getEyeLocation ( ) , 100 ) ;
raycast. addPassthroughMaterial ( Material. LEAVES ) ;
raycast. setOwner ( player ) ;
raycast. setShowRayCast ( true ) ;
if ( raycast. compute ( RaycastType. ENTITY_AND_BLOCK ) ) {
player. sendMessage ( "§aRaycast hurt something" ) ;
Location hurtLocation = raycast. getHurtLocation ( ) ;
player. sendMessage ( "§cRaycast hurt " + ( ( raycast. getHurtBlock ( ) != null ) ? "a block " : "an entity" ) + " at X:" + hurtLocation. getBlockX ( ) + " Y: " + hurtLocation. getBlockY ( ) + " Z:" + hurtLocation. getBlockZ ( ) ) ;
} else {
player. sendMessage ( "§6Raycast hurt nothing" ) ;
}
e. setCancelled ( true ) ;
}
}
![[IMG]](http://proxy.spigotmc.org/0ff8f4e982c90d87c284d678a84da60805116fd0?url=https%3A%2F%2Floisduplain.fr%2Fstockage%2Fspigotmc%2Fraycast%2Fdevelopers.png)
Three types of raycast:
BLOCK -> If you want to detect block collision
ENTITY -> If you want to detect entity collision
ENTITY_AND_BLOCK -> If you want to detect entity or block collision.
--------------------------------------------------
Constructor: Location -> Start location of the ray | Size -> The length of the ray
Raycast#compute(raycastType)
-> Execute the raycast and return boolean (return true if collid with something)
Raycast#getPassthroughMaterials()
-> Return passthrough materials
Raycast#setPassthroughMaterials(ArrayList<Material> passthroughMaterials)
-> Set passthrough materials
Raycast#addPassthroughMaterial(Material mat)
-> Add passthrough material
Raycast#getTestedLocations()
-> Return returns all the locations where the ray has passed
Raycast#getHurtEntity()
-> Return hurted entity. Null if no entity hurted.
Raycast#getHurtBlock()
-> Return hurted block. Null if no block hurted.
Raycast#getHurtLocation()
-> Return the location where the ray hurt something. Null if nothing hurted
Raycast#setShowRayCast(boolean)
-> Show in the world the ray if true when compute() is executed.
Raycast#setOwner(entity)
-> If the ray is emitted by an entity you can set the entity at owner. The ray passthrough the owner.
Quick facts
- Edition: Minecraft Java
- File type: .jar
- Minecraft versions listed: 1.7, 1.8, 1.9
- How to install: Install the matching mod loader (Forge, Fabric or NeoForge) for your Minecraft version. → Download the .jar. → Put it in the .minecraft/mods folder and launch that loader profile.
- Where to get it: Opens on Spigot — not every file is mirrored on our own servers.
Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.
[API] RaycastAPI | Create guns, get towards entity/block is a free Minecraft Java mod. Compatible with Minecraft 1.7, 1.8, 1.9, 1.10 and newer. Downloaded 389 times (via Spigot). Download it and open it directly in the game.