Events

The available events to hook in NovoScript

enable

This event will be called when the module enables

module.onEvent("enable",function(){
    // do stuff
})

disable

module.onEvent("disable",function(){
    // do stuff
})

This event will be called when the module disables

playerUpdateEvent

This event will be called on the local player update if the chunk you're currently at is loaded. Called before preUpdateEvent and postUpdateEvent

module.onEvent("playerUpdateEvent",function(event){
    // do stuff
})

playerPreUpdate

This event will be called before sending all of the position packets

Method	Parameters	Type	Description
getX	None	double	Position X of a player
getY	None	double	Position Y of a player
getZ	None	double	Position Z of a player
setX	double	void	Sets the position X for a player
setY	double	void	Sets the position Y for a player
setZ	double	void	Sets the position Z for a player
getYaw	None	float	Rotation yaw of a player
getPitch	None	float	Rotation pitch of a player
setYaw	float	void	Sets the yaw for a player (Silent)
setPitch	float	void	Sets the pitch for a player (Silent)
isOnGround	None	boolean	The ground state of a player
setOnGround	boolean	void	Sets the ground state for a player

module.onEvent("playerPreUpdateEvent",function(event){
    var y = event.getY();
    event.setY(y + 0.001);
    // do stuff
})

playerPostUpdate

This event will be called after sending all of the position packets

module.onEvent("playerPostUpdateEvent",function(event){
    // do stuff
})

moveEvent

This event will be called before the player moves

Method	Parameters	Type	Description
getX	None	double	X motion of a player
getY	None	double	Y motion of a player
getZ	None	double	Z motion of a player
setX	double	void	Sets the X motion for a player
setY	double	void	Sets the Y motion for a player
setZ	double	void	Sets the Z motion for a player
setMoveSpeed	double	void	Sets the movement speed for the player

// BHop twice as fast as vanilla hop
module.onEvent("moveEvent",function(event){
    if(player.isOnGround()){
        event.setY(player.setMotionY(0.39999999));
    }
    event.setMoveSpeed(player.getBaseMoveSpeed() * 2);
    
})

render2DEvent

This event will be called before the overlay is rendered

Method	Parameters	Type	Description
getPartialTicks	None	float	The delta between the last render tick
getResolution	None	ScaledResolution	Scaled resolution of the window

module.onEvent("render2DEvent",function(event){
    var resolution = event.getResolution();
    render_util.drawFilledRectangle(0,0,resolution.getScaledWidth(),resolution getScaledHeight(),0xffffff);
    // do stuff
})

render3D

This event will be called before the world is rendered

Method	Parameters	Type	Description
getPartialTicks	void	float	The delta between the last render tick

module.onEvent("render3DEvent",function(event){
    var partialTicks = event.getPartialTicks();
    // do stuff
})

loadWorld

This event will be called before the world is loaded

module.onEvent("loadWorldEvent",function(event){
    // do stuff
})

packetSend

This event will be called before the packet is send

Method	Parameters	Type	Description
setPacket	String; Object...	void	Replaces the packet you send with the one you provide. See the example below
getPacket	None	Packet	Returns the packet you send (only a few of them are editable)

module.onEvent("packetSendEvent",function(event){
    if(event.getPacket().getName() == "0x04"){
        var packet = event.getPacket();
        
        // Spoofing ground state to be always true
        {
            packet.setOnGround(true);
        }
        // Another way of doing this
        {
            event.setPacket("0x04",packet.getX(),packet.getY(),packet.getZ(),true);
        }
        // do stuff
    }
})

Cancelling the event

module.onEvent("packetSendEvent",function(event){
    if(event.getPacket().getName() == "0x04"){
        event.setCancelled(true); 
    }
})

Packets

packetReceive

This event will be called before the packet is received

Method	Parameters	Type	Description
getPacket	None	Packet	Returns the packet you receive

// No Rotate
module.onEvent("packetReceiveEvent",function(event){
    if(event.getPacket().getName() == "S0x08"){ // S08PacketPlayerPosLook
        var packet = event.getPacket();
        packet.setYaw(player.getYaw());
        packet.setPitch(player.setPitch());
    }
    // do stuff
})

Canceling the event

module.onEvent("packetReceiveEvent",function(event){
    if(event.getPacket().getName() == "S0x08"){
        event.setCancelled(true);
    }
})

Packets