Signal Stick

MCPets 4.0.0 introduced the in-game editor to simply modify pet options in game, so make sure to check it out using /mcpets editor

That will save you some time not diving in configurations anymore!

What for ?

The Signal stick is a tool that enables you to order your pet to cast skills from MythicMobs. It comes as an item in game that you can customize however you want for each pet.

It comes with two options :

• Left click to switch order (get the next order in the list circularly)

• Right click to cast the order (cooldown can be managed through MythicMobs)

If you want to have a look at what you can achieve with the signal stick, jump at 1:00 on this trailer video:

Drakonin Pack - by Nocsy

How to ?

The Signal stick item is unique for each pet. Also it can be customized using a resource pack (customModelData) or a head (using textureBase64).

The exemple below shows you how to implement the signal stick into the pet config. Have a look at the pet config example if you still have some doubts on how to add this YAML code into your pet config.

The Signal Stick heavily relies on the Signal system of MythicMobs. Check out their wiki page to learn how to implement it in the mob before you try to trigger them using the signal stick of MCPets.

All of the features you can use are also explained below so you can see what it can be used for, note that some of them are optional so you don't need to fill them all.

Signals:
  # List the signals you want to cast to the pet (can be empty)
  # Make sure the pet is actually listening to these signals in MythicMobs or nothing will happen
  # For more information on Signals, check out MythicMobs wiki : https://git.mythiccraft.io/mythiccraft/MythicMobs/-/wikis/skills/mechanics/signal
  Values:
  - ATTACK
  - JUMP
  # Setup the Signal Stick item, it uses the same constructor type as the icon
  Item:
    # Says whether the signal stick item should be available in the interaction menu or not
    # Put false if you want players to get it from another way (like if you added a crafting method, or an NPC that could give it etc...)
    # See the commands for "signalstick" here for more information : https://app.gitbook.com/s/agejyp4OPFjyLRX5Q3cX/~/changes/hJm7QZW7HaVPhmJ6Ct1F/tutorials/plugin-features/commands
    GetFromMenu: true 
    Name: Signal stick name
    Material: STICK
    CustomModelData: 0
    Description:
    - You have a ton to explain here
    - on how to use the stick maybe

Note about signal stick

• Giving yourself the signal stick:

  • To give yourself a pre-configured signal stick, you can use the /mcpets signalStick <player> <petId> command. You can also turn any item into a working signal stick for the pet using /mcpets signalStick <petId> command. Check out the commands here.

• Prevention of bugs and exploits:

  • Signal sticks can not be placed in most crafting stations to prevent players from accidently destroying it, or exploit it to create other items.

Example usage

Let's give an example to show you how to implement an order to your pet.

Let's go into your mob config, usually into "./plugins/MythicMobs/Mobs/".

Let's say you want your pet to deal damage to non-player entities in a radius of 3 around the pet, when the player cast a signal ATTACK to his pet. This would go like this into the Skills sections of your mob config:

Skills:
  - damage{a=10} @EntitiesNearOrigin{r=3;ignore=players;} ~onSignal:ATTACK

Then, within the pet config into "./plugins/MCPets/Pets/", you want to add the following:

Signals:
  Values:
  - ATTACK
  Item:
    GetFromMenu: true 
    Name: Signal stick name
    Material: STICK
    CustomModelData: 0
    Description:
    - Right click to cast a signal to your pet

This will enable the player to get the Signal Stick from the pet's interaction menu, and then cast an ATTACK signal when right clicking with the signal stick.

For more advanced skills to use, make sure to check MythicMobs wiki.