ItemsCore

Breaks a block naturally, dropping its normal loot.

Breaks a block naturally as if mined with the given custom item, dropping its loot.

Changes a block into the material with the given name.

Changes a block into the given material.

Gets the block at the given x, y, z coordinates in a world.

Gets the block at a given location.

Returns all blocks in a box around a location, reaching the given distance on each axis.

Returns the material (type) of a block.

Erupts the floor: turns the solid blocks one layer under the center into real falling blocks in a square of the given radius, launching them upward with the given power so they arc up and drop back into place. Works on every version. Great to call at a projectile's hit location.

Turns a block into air, making it disappear without drops.

Removes a whole list of blocks at once, turning them all to air.

Block animation: rips the solid blocks in a square (radius) and depth (layers) under the source out of the ground and hurls them as real falling blocks forward in the direction the source faces, with an upward and a random spread component. The blocks vanish where they land instead of placing. Pass onLand script code (with landLocation, and player when the source is a player, available) to run an effect at each landing spot, or an empty string for none.

Block animation (entity-relative): copies the solid blocks in a square (radius) and depth (layers) under the entity and lobs that whole patch as one moving island of real falling blocks in the direction the entity faces (forward) with an upward push (up), then it falls back down under gravity. The ground stays intact. Runs the onLand script once at the landing spot (landLocation, and player when the source is a player, are available). Keep forward and up small for a slow lob. For throws not tied to a player position use the location overload throwIsland(location, ...) or throwIslandOf(...).

Block animation (free): copies the solid blocks in a square (radius) and depth (layers) at and below the given center location and lobs that patch as one moving island of real falling blocks with the exact world velocity (vx, vy, vz), then it falls under gravity. Not tied to any player or facing, so the center and direction are entirely yours. The original ground stays intact. Runs onLand once at the landing spot (landLocation, and player if it is in scope, are available). If the center is mid-air with no blocks below it nothing is thrown - use throwIslandOf to build the island from a chosen material instead.

Block animation (built from a material): spawns a square (radius) and depth (layers) island made of the given block material at the center location (no terrain needed, so it works in mid-air or anywhere) and lobs it as one moving group of real falling blocks with the world velocity (vx, vy, vz), then it falls under gravity. Runs onLand once at the landing spot (landLocation, and player if it is in scope, are available). Unknown materials fall back to STONE.

Vein-mines straight from a block break event, shattering the rest of the connected vein around the block that was just broken. Same as veinMine on a block but takes the event so you can call it directly inside a block break handler.

Breaks the whole connected vein of blocks around a block you just mined, as if each one was mined with the given item so it drops its loot. Only blocks that share the start block's material are taken, the start block itself is left to whatever broke it, and the search stops at maxBlocks blocks or once the vein spans maxBox blocks across in any direction. Returns how many extra blocks were broken.

Counts the living entities (mobs and players, not yourself) in the x, y, z box around the player. Combine with isAtLeast for a scaling condition.

Deals the given amount of damage to a living entity (half a heart = 1).

Damages a living entity and credits the damage to an attacker, so kills are attributed correctly.

True when at least one living entity (mob or player, not yourself) is in the x, y, z box around the player. Use it to check for a target before an ability with no code.

Heals a living entity by the given amount, capped at its max health (half a heart = 1). Works on the player, a victim, or any mob.

Knocks an entity away from a location, with extra strength set by the multiplier.

Knocks back every living entity in the x, y, z box around the player, away from the player, at the given strength. Skips the player.

Strikes every living entity in the x, y, z box around the player with lightning. Skips the player.

Pulls every living entity in the x, y, z box around the player toward the player at the given strength. Skips the player. Great for a black-hole or vacuum ability with no looping code.

Sets a living entity's health to an exact amount (half a heart = 1). Works on the player, a victim, or any mob.

Damages every entity near the given entity (except itself) within the given x, y, z range. The center can be the player, a victim, or any mob.

Deals splash damage to every living entity within the given x, y, z box around a location, crediting the attacker. Built for throwBlocks landing callbacks using landLocation.

Returns a player's money balance (requires the Vault plugin).

Adds money to a player's balance and returns whether it succeeded (requires the Vault plugin).

Removes money from a player's balance and returns whether it succeeded (requires the Vault plugin).

Gives a living entity a potion effect for a duration (in ticks) at the given strength level. Works on the player, a victim, or any mob.

Finds an entity in a world by its numeric entity id, or nothing if not found.

Finds an entity in a world by its UUID text, or nothing if not found.

Returns the location of a living entity's eyes (their head, where they are looking from).

Returns all entities near an entity (player, victim, or any mob) within the given x, y, z distances.

Returns only the LIVING entities near an entity (players and mobs) within the given x, y, z distances. Skips dropped items, arrows, xp orbs and other non-living entities, so area effects only hit real targets.

Removes an entity from the world (kills it without drops).

Spawns an entity of the given type at the x, y, z position and returns its UUID as text.

Adds a colored firework effect to a held firework rocket or firework star. type is BALL, BALL_LARGE, STAR, BURST or CREEPER and the burst takes the given RGB color. Does nothing if the held item is not a firework.

Adds an amount to a numeric value stored on the held item (counting from 0 if it was never set) and returns the new total. Perfect for upgrade progress like blocks mined or kills.

Adds a potion effect to a held potion, splash/lingering potion or tipped arrow. type is an effect name like SPEED or STRENGTH, duration is in ticks (20 = 1s), amplifier 0 = level I. Does nothing if the held item has no potion data.

Empties a player's entire inventory.

Drops an item on the ground at a location.

Drops the given material on the ground at a location.

Returns the boots a player is wearing.

Returns the chestplate a player is wearing.

Returns the helmet a player is wearing.

Returns the item in a specific inventory slot of a player.

Returns how many ticks of vanilla cooldown are left on the item that triggered this ability (20 ticks = 1 second), or 0 if it is ready.

Builds the actual in-game ItemStack for one of your custom items.

Returns the value of one of a custom item's stats by name, or 0 if the item does not have it.

Reads a value stored on the player's held item with setItemVariable. Returns nothing if the item has no such value.

Reads a value stored on the held item as a number (0 if it was never set or is not a number). Use it to do math with item variables like a kill or soul counter.

Reads a value stored on the held item, or returns the given default if it was never set.

Returns the leggings a player is wearing.

Looks up a Minecraft material (block or item type) by its name.

Gives the player a fresh copy of a custom ItemsCore item by its id, amount times. Each copy is brand new and unique. Use it to hand out rewards from a voucher or crate.

Gives a player one of the given material as an item.

Checks whether an item is a custom ItemsCore item with the given id.

Returns true while the item that triggered this ability (held, or the worn armour piece) is still on a vanilla cooldown from setItemCooldown. Use it to block an action until the cooldown ends.

True when a numeric value stored on the held item is at least the given amount. Reads with getItemVariableNumber. Use it for a charge or soul counter condition with no code.

True when a numeric value stored on the held item is at most the given amount. The mirror of isItemVariableAtLeast, for an empty/low counter condition.

Checks whether a custom item is a talisman (a passive item kept in the inventory).

True when the player is wearing all four armour pieces of a set, matched by id prefix (e.g. "spirit" matches spirit_helmet, spirit_chestplate, spirit_leggings, spirit_boots). Perfect for a full-set bonus condition with no code.

Changes how the player's held item LOOKS by swapping its material, while it stays the exact same custom item (same id, lore and behavior) - it is now Morphed. The original material is remembered so unmorphHeldItem can restore it.

Creates a new player head item showing the given player's skin.

Sets an existing player-head item to show the given player's skin.

Redraws the held item's lore from its template, filling in placeholders like {var_level} with the values stored on that item. Call it after changing an item variable so the lore updates live. Write {var_yourKey} in the item's lore in the editor.

Removes one of the item the player is currently holding from their hand.

Puts a real vanilla cooldown on the item that triggered this ability (the held item, or the worn armour piece for an armour ability) for the given number of seconds. Held items grey out with the sweeping overlay, exactly like an ender pearl; worn armour cannot show the overlay, so gate armour abilities with the action's own cooldown field instead. Needs Minecraft 1.11 or newer.

Stores a value on the player's held item itself (not the player). The value travels with that exact item even when it is moved, dropped or traded. Use it for per item state like an upgrade level or a kill counter. Returns the updated item.

Dyes the held leather armor piece the given RGB color (each 0-255). Does nothing if the held item is not leather armor. Updates the look live, like a morph.

Dyes the held leather armor piece from a hex color like #ff0000. Does nothing if the held item is not leather armor.

Creates a player-head item showing the skin of the given player name.

Creates a player-head item from a base64 skin texture value (the kind sites like minecraft-heads give you).

Creates a player-head item from a base64 skin texture and its Mojang signature, for verified skins that need both.

Subtracts an amount from a numeric value stored on the held item and returns the new total. The mirror of addItemVariable, for spending a counter.

Restores a morphed held item back to the original material it had before morphHeldItem. Does nothing if the item was never morphed.

True only when both conditions are true. Use it to combine two checks without writing code.

Cancels the current event so the normal action (like the block break or damage) does not happen.

Returns true with the given percent chance (0-100). Great for random ability procs.

Runs a piece of script code only if the condition is true.

Runs one piece of script code if the condition is true, otherwise runs the other piece.

True when the first number is at least (greater than or equal to) the second.

True when the first number is at most (less than or equal to) the second.

True when two numbers are equal.

True when the first number is greater than the second. Use it as a doIf condition instead of writing raw code.

True when the first number is less than the second.

Flips a true/false value. Use it to run something when a condition is NOT met.

True when either condition is true.

Picks one random entry from a comma separated list (or a real list) and returns it. Roll a random reward, message or command with it.

Returns a random whole number between min and max, both included.

Runs a piece of script code right now.

Runs a piece of script code after a delay measured in ticks (20 ticks = 1 second).

Runs an already-built runnable (from core.createRunnable) after a delay measured in ticks (20 ticks = 1 second). Prefer this over runCodeLater so the runnable is compiled once instead of evaluating a code string at runtime.

Repeatedly runs a piece of script code a set number of times, waiting the given ticks between each run (-1 times means forever). The current loop number is available as tIndex.

Runs a piece of script code once for each item in an array, with the current item available as currentArrayObject.

Keeps running a piece of script code every few ticks while a condition stays true.

Turns a list (like getNearbyLivingEntities) into an array so you can pass it straight to loopThrough, with no .toArray() code.

Waits until a condition becomes true, then runs a piece of script code (the safe value limits how long it waits).

Adds two numbers. Use it to build a value out of nested calls, like a base plus a scaling part.

Keeps a number between a low and a high bound (returns the bound if it is outside the range).

Divides the first number by the second (returns 0 if dividing by zero).

Returns the larger of two numbers.

Returns the smaller of two numbers. Use it to cap a value, e.g. spend at most a limit of a counter.

Multiplies two numbers. Use it to scale an amount, like souls times a damage-per-soul value.

Subtracts the second number from the first.

Broadcasts a message to every player on the server.

Turns & color codes in a piece of text into real Minecraft colors.

Sends a chat message to one player, supporting & color codes and hex (&#rrggbb).

Builds a direction/velocity vector from x, y, z math expressions.

Launches the player forward in the direction they are looking, with a horizontal power and an upward lift. Use it for a dash, leap or blink-step.

Stops a player from flying.

Lets a player fly.

Freezes an entity in place for the given duration (in ticks) by keeping it at its current spot.

Turns an entity to face the given yaw and pitch without moving it.

Pushes an entity (player, victim, or any mob) using x, y, z math expressions as the velocity direction and strength.

Pushes an entity (player, victim, or any mob) using a ready-made velocity vector.

Teleports an entity to the given x, y, z in its current world (keeps its facing direction).

Dashes a living entity forward in the direction it is looking, up to the given range (skipBlocks=true lets it pass through walls).

Teleports one entity directly to another entity's position.

Teleports an entity to a specific location.

Creates an empty particle animation. Set its orientation (world/yaw/look), anchor (feet/body/eyes/above_head), speed and period, then add layers made with core.createAnimationLayer(). Play it with particles.playAnimation.

Creates one particle animation layer. Set its shape, particle or color1/color2, colorMode, radius, count, spin and more, then add it with animation.getLayers().add(layer).

Spawns a particle effect at the x, y, z position every tick for the given number of ticks.

Spawns a particle effect at a location every tick for the given number of ticks.

Makes a player run a command as if they typed it in chat.

Finds an online player by their name, or returns nothing if they are offline.

Finds an online player by their UUID.

Finds an online player by their UUID written as text.

Returns the value of one of a player's custom stats by name.

Hides a player so no other online player can see them.

Hides a player from everyone, then makes them visible again after the given number of ticks.

True when the player's health is below the given fraction of their maximum (0.3 = below 30%). Great for a low-health proc with no code.

True when the player is barely moving (standing still). Use it to gate an effect that only runs while still, with no velocity math.

Returns the list of all players currently online on the server.

Changes a player's game mode (survival, creative, adventure, spectator).

Makes a hidden player visible to everyone again.

Makes a player visible to everyone, then hides them again after the given number of ticks.

Builds a movement equation (using 't' for time in ticks) that shapes a custom projectile path. Axes are relative to the shooter's facing: X = forward (the way they look), Y = up, Z = left. A normal forward-flying projectile puts the motion on X, e.g. createEquationVector("t * 0.4", "0", "0"); use Y for arc and Z to curve sideways.

Builds an item projectile body from a material name, handy for flinging a block or any item as an ITEM projectile. Same chainable styling as the ItemStack version (small/visible/marker/rotation/spin/trail).

Builds an item projectile body: an invisible armor stand wearing the given item on its head. Pass it as the val of shootProjectile with type ITEM. Chain small(true) for a small stand, visible(true) to show the stand, marker(false) to give it a hitbox, rotation(x, y, z) to tilt the item in degrees, spin(degreesPerTick) to make it spin while it flies, trail(particleDisplay) to leave a particle trail, and trailEvery(ticks) to thin that trail out.

Makes a living entity shoot an arrow in the direction it is looking.

Fires a custom ItemsCore projectile from a player. The type is one of PARTICLE or ITEM, val is the body to fly (a ParticleDisplay, or a projectileItem(...) for ITEM), timeAliveTicks is how long it lives, splashHit keeps it going through entities, and the last argument is the flight path from createEquationVector.

Looks up a Minecraft sound by its name.

Plays a sound to a player at a location with the given volume and pitch.

Returns the current system time in milliseconds, handy for cooldowns.

Replaces PlaceholderAPI placeholders in text with their real values for a player.

Reads a global (server-wide) saved variable by name, creating it empty if it does not exist.

Reads a saved variable stored on a player, creating it empty if missing (use temp=true for variables cleared on logout).

Reads a player's saved variable, or sets and returns a default value if it does not exist yet.

Saves a global (server-wide) variable by name so it persists and can be read later.

Saves a variable on a player (use temp=true for variables cleared when they log out).

Returns a new location shifted by the given x, y, z amounts.

Makes a copy of a location so you can change it without affecting the original.

Creates an explosion of the given power at the x, y, z position in a world.

Creates an explosion of the given power at a location.

Builds a location object from a world and x, y, z coordinates.

Gets a world by its name, or nothing if no world has that name.

Strikes lightning at the given x, y, z position in a world.

Strikes lightning at a location.

Plays a particle animation on a player for a number of ticks (20 = 1 second). The same orientation/anchor/shape-layer engine the runes use. Build the animation with core.createAnimation() and core.createAnimationLayer().

Plays a saved animation by name on a player for a number of ticks (20 = 1 second). This is the easy no-code way: build the animation in /ic animations, then just name it here. No core.createAnimation needed.

Plays a saved animation by name at a fixed world location for a number of ticks (20 = 1 second). The no-code way for block or hit-point effects: build it in /ic animations, then reference the name here.

Plays a particle animation at a fixed world location for a number of ticks (20 = 1 second). Use this for animations not tied to a player, such as on a block or a projectile hit point.

Draws a static atom with orbit rings and a nucleus of particles at the display's location.

Animates an atom with spinning orbit rings of particles at the display's location for a number of ticks.

Draws a black sun shape made of shrinking circles at the display's location.

Animates a swirling blackhole of particles at the display's location for a number of ticks (mode changes the shape).

Draws a cage of vertical particle bars between two corner locations, useful for trapping effects.

Animates a chaotic double-pendulum swing of particles at the display's location for a number of ticks.

Draws a circle (or oval) of particles at the display's location.

Draws a moving beam of pulsing circles that travels forward in the display's direction for a number of ticks.

Continuously spawns a raincloud effect using the two given particle displays.

Draws a cone of particles standing up from the display's location.

Draws a crescent moon shape of particles at the display's location.

Draws a hollow cube (all six faces filled) of particles between two corner locations.

Draws a cylinder of particles standing up from the display's location.

Draws a diamond (rotated square) shape of particles standing up at the display's location.

Draws a DNA double-helix of particles rising from the display's location, with bond lines between the strands.

Animates a growing DNA strand with colored nucleotide bonds rising from the display's location.

Draws a straight line of particles out from a living entity's eyes in the direction it is looking.

Draws an ellipse (oval) arc of particles between the start and end angles at the display's location.

Animates an expanding explosion shockwave of particles at the display's location.

Draws an eye shape of particles at the display's location.

Draws a solid filled disc of particles at the display's location.

Draws a fully solid cube of particles between two corner locations.

Draws a flower-petal pattern, running the given task at each petal point around the display's location.

Draws a heart shape of particles at the display's location.

Animates a spiral helix of particles rising in the display's direction (fadeUp and fadeDown taper the ends).

Draws nested wireframe cubes connected like a 4D hypercube between two corner locations.

Draws an illuminati triangle-with-an-eye symbol of particles at the display's location.

Draws an infinity (figure-eight) symbol of particles at the display's location.

Draws a flat Julia-set fractal pattern of particles at the display's location.

Draws a jagged branching lightning bolt of particles from a start point in a direction.

Draws a straight line of particles between two locations.

Continuously draws growing magic circles that travel forward in the display's direction.

Draws a flat Mandelbrot fractal pattern of particles at the display's location.

Draws a pentagram star inside a circle at the display's location.

Draws a polygon outline of particles with the given number of points at the display's location (use connection to make stars).

Draws a multi-colored rainbow arc of particles at the display's location.

Draws a filled flat rectangle of particles between two corner locations.

Draws a ring (donut/torus) shape of particles at the display's location.

Draws a sword-slash arc of particles at the display's location (useWideSide makes the wider half of the swing).

Draws an animated sword slash that travels forward in the display's direction over a distance.

Draws a hollow sphere of particles at the display's location.

Draws a spiky ball of particles (a sphere with random spikes sticking out) at the display's location.

Animates scattering lines of particles from a start point toward a randomly spread end area.

Animates a spiky star burst of particles at the display's location.

Draws only the edges (wireframe) of a cube of particles between two corner locations.

Animates a rotating 4D tesseract of particles at the display's location for a number of ticks.

Animates a spinning vortex of spreading particles at the display's location for a number of ticks.

Draws a wavy rippling surface of particles at the display's location.

Creates a colored dust particle display from red, green, blue (0-255) and a size.

Builds a fully customized particle definition (count, size, color, block/item data and more) to turn into a display.

Turns a custom particle definition into a particle display you can use in shapes.

Creates a particle display from a particle name, used as the look for particle shapes.

Returns a random whole number between the two values (both ends included).

Returns a random decimal number between the two values.

Sets the direction a particle display points in.

Sets the location where a particle display will be drawn.

Turns a piece of text into its real type (number, true/false, or text) automatically.

Reads a script variable that is currently available by its name.

Checks whether the Vault economy plugin is installed and available.

Finds one of your custom items by its name, or nothing if no item has that name.

Returns the custom name of an item stack.

Gives a player one of your custom items.

Returns the custom item a player is holding, or nothing if it is not an ItemsCore item.

Returns the helper used to ask a player for typed chat input.

Returns a player's live total for a stat: its base value plus the stat from every held, worn, off-hand and talisman item (reforges included). Use it to calculate damage or feed another plugin.

Returns all of a player's live total stats as a map of stat name to value.

Forces an immediate recalculation of a player's live total stats. Call it right before reading a stat if you need a value that reflects a change made this same tick.

No description yet.