arielle-RpChatter icon

RpChatter

chat mod that adds commands like /me

Last updated 2 months ago
Total downloads 2689
Total rating 4 
Categories Misc Server-side Client-side
Dependency string arielle-RpChatter-3.0.0
Dependants 4 other packages depend on this package

This mod requires the following mods to function

denikson-BepInExPack_Valheim-5.4.2202 icon
denikson-BepInExPack_Valheim

BepInEx pack for Valheim. Preconfigured and includes unstripped Unity DLLs.

Preferred version: 5.4.2202

README

RPChatter Mod for Valheim

Overview

RPChatter is a Valheim mod that enhances in-game communication for roleplay servers by adding customizable chat commands, aliasing, and a text-based Blackjack minigame. This mod allows for enriched roleplay interactions and chat-based gameplay, including emotes, whispers, announcements, and dice rolling.

Features

  • Chat Roleplay Commands: Use /me, /ges to enrich in-game interactions.
  • Customizable Name Colors: Set different colors for various chat types.
  • Secret Identities: Hide your real name and use an alias with /setalias and /hide.
  • Randomized Actions: Use /roll and /coinflip for immersive roleplay mechanics.

Installation

  1. Install BepInEx.
  2. Download and place the RPChatter.dll in BepInEx/plugins.
  3. Start the game and configure chat settings via the config file.

Commands

Vanilla Chat Commands

Command Description
/ <msg> Say, normal text shows above your player and in the chat to everyone in 25m
/s <msg> Shout, shout text shows to everyone in 125m. Displays real name even if using an alias.
/w <msg> Sends a quiet message to nearby players within 5m

Roleplay Chat Commands

Command Description
/me <action> Describes an action (e.g., /me laughs loudly). Same range as Say
/ges <action> Describes an action more discretely to nearby players. Same range as Whisper

Alias Commands

Command Description
/setalias <name> Changes your display name to an alias.
/clearalias Removes your alias and restores your real name.
/hide Toggles hiding your real name.

Limited Range

  • Whisper 5m
  • Say 25m
  • Shout 125m
  • Ping 25m
  • Broadcast (Server-wide) Admin only

Game Commands

Command Description
/roll [min max] Rolls a number between the given range (default: 1-100).
/coinflip Flips a coin (Heads/Tails).
/ur Roll four tetrahedral dice. Used to play the Royal Game of Ur
/shuffle Creates a fresh shuffled 52-card personal deck
/draw [count] Draw 1-10 cards from your personal deck

Tarot Commands

Command Description
/tarot.shuffle Creates a fresh shuffled tarot deck
/tarot.draw [count] Draw 1-10 cards from your personal tarot deck

Farkle Dice Game

RPChatter includes a playable chat-based Farkle dice game. Players roll dice, keep scoring dice, and decide when to bank their points before risking a Farkle. The game runs client-side and is designed for tavern gambling and roleplay events.

Farkle Commands

Command Description
/farkle.start Start a new Farkle game and reset your score.
/farkle.roll Roll the available dice.
/farkle.keep <dice> Keep scoring dice (example: /farkle.keep 155 or /farkle.keep 5 5 5 1).
/farkle.bank Bank your current turn score and end your turn.
/farkle.score Show your current total score and turn score.
/farkle.end End the current Farkle game.
/farkle.help Display the Farkle rules in chat.

How to Play

  1. Start a new game: /farkle.start
  2. Roll the dice: /farkle.roll
  3. Choose scoring dice to keep: /farkle.keep <dice> If you try to keep dice you didn't roll your turn ends. Do not cheat!
  4. Continue rolling remaining dice to increase your turn score. If you cannot score, you farkle and lose all unbanked points
  5. If you score with all 6 dice you get to roll 6 again! Hot dice!
  6. At any time you may bank your points: /farkle.bank
  7. Banking adds your turn score to your total score and ends your turn.

Farkle

If you roll and no scoring dice appear, you Farkle.

Hot Dice

If you keep all six dice, you earn Hot Dice, allowing you to roll all six dice again and continue building your turn score.

Scoring

Dice Combination Points
Single 1 100
Single 5 50
Three 1s 1000
Three 2s 200
Three 3s 300
Three 4s 400
Three 5s 500
Three 6s 600
Four of a kind 1000
Five of a kind 2000
Six of a kind 3000
Straight (1–6) 1500
Three pairs 1500
Two triplets 2500

Winning

Farkle is typically played to 10,000 points. When a player reaches 10,000, all other players receive one final turn to beat the high score.

Configuration

Modify the color settings for different chat types in the BepInEx config file:

BepInEx/config/RPChatter.cfg

Each setting allows players to configure their own colors locally without being overridden by the server.

Config Key Description Default (Hex) Default (RGBA)
chatMessageUsernameColor Color for the username shown in chat messages. #D65804 (0.839, 0.345, 0.016, 1)
chatMessageTextDefaultColor Color for default/system chat messages. #989749 (0.596, 0.592, 0.286, 1)
chatMessageTextSayColor Color for “normal/say” chat messages. #989749 (0.596, 0.592, 0.286, 1)
chatMessageTextShoutColor Color for “shouting” chat messages. #FFFF00 (1.000, 1.000, 0.000, 1)
chatMessageTextWhisperColor Color for “whisper” chat messages. #99A6BF (0.600, 0.650, 0.750, 1)
chatMessageTextMeColor Color for “emote” chat messages (e.g. /me). #989749 (0.596, 0.592, 0.286, 1)
chatMessageTextGesColor Color for “gesture” chat messages (e.g. /ges). #85867A (0.520, 0.520, 0.480, 1)
chatMessageTextGameColor Color for “game” chat messages (e.g. /roll, /coinflip). #E1AD21 (0.882, 0.678, 0.129, 1)
chatMessageTextPingColor Color for “ping” chat messages. #00FFFF (0.000, 1.000, 1.000, 1)
chatMessageTextMessageHudColor Color for MessageHud (center-banner) messages. #999999 (0.600, 0.600, 0.600, 1)
chatMessageTimestampColor Color for timestamps in chat messages. #F4F6F7 (0.957, 0.965, 0.969, 1)

How to Change Colors

  1. Open the config file in a text editor:
  2. Modify the hex color values to your preference.
  3. Save the file—changes will apply automatically if the game is running.

These settings are client-side only, meaning each player can have their own custom colors without affecting others.

Development & Contribution

  • This mod is built with BepInEx and Harmony.
  • 2.0 was restructured and remade with heavy support from redseiko of Comfy.
  • Build in support of ValheimRoleplay! Come make-believe with us.

Enjoy immersive roleplay with RPChatter! 🎭🔥