Kerkele Companion

Have you ever felt a little bit lonely in your world? Would you like to have a companion to talk to, gift cool items or simply follow you on your adventures?

Kerkele companion mod adds a custom demon character with 300+ dialogue lines, complex relationship system and unique behaviour for you to interact with!

Starters:

Kerkele doesn’t spawn naturally in the world, to meet him you will have to use a Summoning scroll.

(all recipes can be found in gallery).

Items:

• Summoning scroll: Click with the scroll on the ground to summon Kerkele. If you already summoned one, you can use the scroll to teleport him. Click on the block, and he will teleport somewhere close to you! (Works both in Nether and Overworld) WARNING! Use the scroll only when you both are in the same dimension! (If you are in different dimensions, sometimes there is a bug when it can spawn a duplicate, so be careful) (Also, you can still use /summon command if you want to spawn more than one)
• Herbal tea, rose tea: food items with small bonus effects.
• Chocolate cake, candy: His favourite treats~
• Soul gem: a special gift you get after reaching maximal relationship points with Kerkele. Similar to the totem of undying, but reusable.
• Gift: after giving Kerkele an offering, there is a chance to get something in return~
• Paintings: The mod also ads 4 new paintings featuring Kerkele portrait, drawing of his favourite flowers, summoning scroll and a bottle of honey.

---

Relationship system:

You can gradually improve your relationship with Kerkele to unlock different commands, behaviour or special responses. There are 4 relationship stages: Strangers, Acquaintances, Friends and Companions. Depending on different interactions you can increase/decrease your relationship with Kerkele.

Give him nice gifts, compliment or pet him to keep him happy. But if you give him bad offerings, assault or even hit him, he won’t like you much…

Stages:

Strangers ( 0 - 50 points) :

(Default behaviour)

• Putting music discs in jukeboxes,
• Help with hanging a painting,
• come here (chat command),
• Dialogue interactions,
• Offerings,
• Petting

Acquaintances ( 50 - 150 points) :

(unlocked mechanics)

• Protect me (chat command),
• sit down - get up (chat command),
• Flower picking,
• Chests/Barrels gifts,
• Furnace interaction,
• Follow me (chat command),
• Shearing Kerkele

Friends ( 150 - 250 points) :

(unlocked mechanics)

• Protect me +,
• Lie down - get up,
• Chests/Barrels gifts +,
• Feeding the player,
• Book enchantments,
• New responses on certain chat lines {I like you, I love you, you are mine, can i touch your tail, do you watch me, don’t leave me, I missed you}
• 'a hug?' command

Companions (max 400 points) :

(unlocked mechanics)

• Protect me ++,
• Automatic protection while following,
• Chests/Barrels gifts ++,
• Book enchantments +,
• New responses on certain chat lines {I like you, I love you, you are mine, bye/goodbye},
• Max relationship gift event,

---

Offerings:

You can give him gifts!

To offer something, right click on Kerkele with the item in main hand. Depending on the item he can accept/refuse it. If he accepts an offering, there is a chance he will give you a white box gift in return. Upon clicking with it on a block, it will give you a random item. Depending on your relationship with Kerkele, the chance of getting a gift in return may be higher.

Possible items from gift box:

emeralds, golden ingots, cookies, apples, diamonds, nether star, wither rose…

Overall there are 40+ gift options, most of which have unique responses.

Gifts based on liking:

Favourite:

• honeycomb, candy, honey bottle, honey blocks
• chocolate cake
• rose bush

Good:

• All flowers, poppy, red tulip
• golden apple, enchanted golden apple
• heart of the sea, diamond, amethyst shard, echo shard
• herbal tea, rose tea
• cake, pumpkin pie, cookie
• gold ingot, emerald
• glow berries, sweet berries, apple, melon slice
• golden carrot, glistering melon slice
• rotten flesh, pufferfish, fermented spider eye, rabbit foot

Neutral:

• carrot, baked potato, kelp/dried kelp
• all cooked fish/meat

Bad:

• brown/red mushroom, dirt,coal,gunpowder,bone,charcoal,mushroom stew,nether wart
• raw salmon
• sadle, lead

---

Behaviour:

Kerkele can interact with different workstations or do you some favours:

(some of interactions are enabled when you increase the relationship)

• Chests/barrels : He can put random items in storage blocks for you to find!
• Furnace : He can cook some food for you!
• Jukebox : If there is a jukebox nearby, Kerkele may put a random music disc for you to listen to!
• Flower picking : Sometimes if there is a flower nearby, he will bring you one! (you can disable this behaviour in chat, the command is in chat responses section)
• Feeding mechanic: If you have a few empty hunger bars, Kerkele can bring you something tasty to chew on!
• Book enchanting: If you give Kerkele a book, he can cast some nice spell on it for you.
• Painting Hanging: Don’t know where to hang a picture? Give it to Kerkele, he may find a nice spot for it! ( sometimes you will have to push him a little closer to the wall for him to hang it)
• Sitting: if you want Kerkele to stay at one place you can order him to sit down!
• Lying down: Unlike sitting, Kerkele can lie down only on soft spots like carpets, wool blocks or beds, that are at least 2*3 blocks big. (sometimes you will need to push him a little bit closer to lying spot so he could lie down)
• Night rest: At night Kerkele may lie down and rest for a bit if there is a nice soft spot nearby.
• Petting: he likes gentle scratches from time to time! (Right click with empty hand while crouching)

---

Combat:

Kerkele is quite peaceful unless you explicitly provoke him. If you were to accidentally hit him, a small friendly fire isn’t something he’ll get angry about. But if you repeatedly try to provoke him, he’ll be quick to respond…

---

Upon clicking interactions:

• Right click with empty hand: Response from Kerkele
• Right click with empty hand while crouching: Pet Kerkele
• Right click with item in hand: Give Kerkele a gift
• Right click with painting in hand: Ask Kerkele to hang a painting for you
• Right click with book in hand: Ask Kerkele to cast you a spell on the book
• Right click with shears in hand: Give Kerkele a trim

---

Chat Dialogues:

Upon right click with empty hand Kerkele sometimes makes a comment in chat. The response may depend on weather, time of day or a biome you are in.

(overall there are 50+ biome responses with 35 detected biomes! )

And here are chat lines he will react to.

(Almost all of the lines have multiple response variants + most of them are not sensitive to higher/lower case. (for example, both ‘I like you‘ and ‘I LIKE YOU’ will work) Some of the words are trigger words(if in a sentence, they will already trigger response. For example, ‘Do you like parrots’ or ‘Parrots!’ will both get him to respond)

- What you can call him:

• kerkele/Kerkele
• KERKELE
• kerli/kerly
• kereleke/kerele/kerlek/kerleke/kreleke/krelke/kerek (mispronouncing)
• kreker
• cockroach
• stupid/moron/dumb
• monster
• i hate you

- Mobs he can comment on (all trigger words, first 9 only in plural):

• witches
• pillagers
• evokers
• bees
• parrots
• cats
• dogs
• piglins
• wither skeletons
• lenny
• knocker

- Basic lines:

• hi/hello
• bye/goodbye
• good evening
• good morning
• thanks/thank you
• I am sorry/ Im sorry/ I'm sorry
• I am really sorry/ Im really sorry/ I'm really sorry
• I am not afraid/ I am not afraid of you/ I'm not afraid of you
• I built a house/I have a house/ This is my house
• I have a farm
• I found a diamond/ I found diamonds
• I have a cat/cats
• I have a gift/ I have something

- Compliments:

• you are handsome/pretty/charming/gorgeous/beautiful
• you look lovely today
• hi handsome/pretty/lovely
• hi babygirl
• you have a cute tail

- Progressing messages(response depends on your relationship level):

• i like you
• i love you
• you are mine
• can i touch your tail
• i miss you/i missed you
• bye/goodbye
• do you watch me/are you watching me
• dont leave me/don't leave me

- Questions:

• who are you?
• where are you from?
• what is your name?
• any selfcare tips for me?
• why me?
• how old are you?
• will you stay with me/can you stay with me?
• are you evil?
• do you like it here? (also gives biome response)
• what do you like?
• Are you hurt? ( Tells you how much health Kerkele has. Approximately, not an exact number)

- Other lines:

• .../..../.....
• ?/??/???
• meow
• 67?
• 11037
• herobrine/herobrian
• werner ziegler
• Dreap

—-----------------------------------------------------------------------------------------------------

Command lines (Not all are enabled from the start. If you have low relationship, he will refuse some of them):

• lie down - get up
• sit down - get up
• protect me {comes to you and protects you from monsters}
• follow me - stop following me {makes Kerkele actively follow you}
• come here { comes close to you}
• do not pick flowers / don't pick flowers - pick flowers { Enables/disables flower picking. enabled by default. } ( in case he picks flowers from your garden and it irritates you ;) )
• stay there - you can wander now { sets an area in which Kerkele stays so he won’t passively follow player around.)
• call me username - {allows player to choose a nickname, so Kerkele won't refer to them by username. for example: 'call me Rita' }
• be passive - don't be passive {enables/disables passive protection while following. enabled by default}
• a hug? (enabled for friends and higher)

Relationship commands:

• get relationship - gives you your relationship stage and points.
• reset relationship - resets your relationship with Kerkele to 0.

---

Accesories:

Added 10 new accessories! (Right click on Kerkele with fitting dye to change his appearance):

• Light blue, lime/green,pink dye- different bow
• magenta dye - pink flower wreath and bow
• orange dye- scarf and gloves
• cyan dye - scarf, socks and fur earmuffs
• white dye - 2 variants: just a bow in front/ hair bow + transparent silk gloves (click 2 times with white dye to get second variant)
• Light gray dye - white flower wreath
• golden nugget - golden wreath
• Red dye - default red bow

---

---

Credits:

Models, textures- Rita1771(me)

Dialogue lines - Rita1771(me) (Except a few silly minecraft puns I picked up here: https://www.wattpad.com/431927629-try-not-to-laugh-completed-minecraft-jokes )

Code AI Warning: I used AI for implementing some mechanics in my code since I did not have a Java coding/minecraft mod making experience before. AI assisted me with writing code parts for some of block interactions (specifically jukebox usage, chests and barrels gifts, painting hanging, flower picking ), which I reviewed, studied and then adapted in my code.

All models, textures and dialogue content was made without use of generative AI, by me solely.

---

Mod usage:

If you create a piece of media using my mod(for example a video) I would be thankful if you gave me credit.

I Do Not give consent for a creation of any ai chat bots based on my character !

---

P.s. If you find bugs, want to give feedback or have some ideas on what I should implement in update, please contact me in discord. I open it more frequently, therefore more likely to see your message!