Skip to content
うっちぃ edited this page Aug 3, 2020 · 38 revisions

Command reference

Command for general users

lunachat command

Command lunachat, abbreviation ch or lc, available by default to all users.

  • /ch create (channel) [description]-create a channel.
  • /ch join (channel)-Join the channel.
  • /ch join !-Change the talk destination to normal chat.
  • /ch leave-Leave the participating channel.
  • /ch list-Display a list of channels.
    The channel set as the current speaker is displayed in red, the participating channels are displayed in white, the hidden channels are displayed in dark blue, and the non-participating channels are displayed in gray.
    The number shows the number of participants (online number/total number of participants).
  • /ch info [channel]-Display channel information.
    If you don't specify the channel, the information of the channel you are in will be displayed.
    Online members are white, hidden members are dark blue, and offline members are gray.
    Channel moderators have an "@" in front of their name.
  • /ch log [channel] [d=date] [p=player] [f=filter]-Displays the channel log (for the current day). To refer to the log of the past date, specify the date you want to refer with a 4-digit number after d=, such as /ch log d=0920. If you want to filter the log by player name, specify p=(player name), and if you want to filter by content, specify f=(keyword).
  • /ch accept-Accept the invitation and enter the channel chat.
  • /ch deny-refuse the invitation.
  • /ch hide (channel) or /ch hide channel (channel)-Hide the content of the specified channel.
    If you don't specify a channel, the channel you are in will be hidden.
  • /ch hide (player) or /ch hide player (player)-Hides what the specified player says.
  • /ch hide list-Shows a list of currently hidden channels and players.
  • /ch unhide (channel) or /ch unhide channel (channel)-Returns the content of the specified channel to the display.
  • /ch unhide (player) or /ch unhide player (player)-Returns the speech of the specified player to the display.
  • /ch or /ch help-displays help.

msg command (tell command)

1:1 chat command message, abbreviation msg or tell, m, t, w, available by default to all users.

  • Overrides the behavior of the default tell command.

  • /tell (name) [message]-Starts and sends a 1:1 chat with the specified person.

r command

1:1 chat reply command reply, abbreviation r, available to all users by default.

  • /r [message]-Reply to the received 1:1 chat.

jp command

Japanese conversion on/off command lcjapanize, abbreviation japanize or jp, can be used by all users by default.

  • /jp off-Turns off your own chat Japanese translation. Use this when you want to speak English, such as when dealing with overseas players.
  • /jp on-Turns on your own chat Japanese translation.

Channel moderator commands

The channel moderator is set to the person who first created the channel.

  • /ch invite (name)-Invite the specified person to join the channel chat.
  • /ch kick (name) [channel]-Kick the specified person from channel chat.
  • /ch ban (name) [channel]-BAN the specified person from channel chat.
  • /ch ban (name) [minutes]-BAN the specified person for the specified number of minutes.
  • /ch pardon (name) [channel]-Removes the BAN of the specified person.
  • /ch mute (name) [channel]-Mute the specified person from channel chat.
  • /ch mute (name) [minutes]-Mute the specified person for the specified number of minutes.
  • /ch unmute (name) [channel]-Unmute the specified person.
  • /ch remove-removes the channel.
  • /ch format (format)-sets the channel message format.
    It can be set with keywords. Details will be described later.
  • /ch moderator (player...)-set the moderator for the channel.
    You can specify multiple people at once. If you want to remove it from the moderator, please add a minus "-" before the name. Details will be described later.
  • /ch option (key=value...)-set options for the channel. Details will be described later.

Administrator command

  • /ch template (number) (template...)-Register a message format template.
    To use a template, write the template number after the replacement keyword % with the /ch format (format) command and set it.
  • /ch dictionary add (from) (to)-Add new contents to the word dictionary when converting to Japanese. /ch dictionary can be shortened to /ch dic. Specify the character string that replaces the word to be matched with from to. Execution example) /ch dic add google Google
  • /ch dictionary remove (word)-Removes the specified word from the word dictionary when converting to Japanese.
  • /ch dictionary view-Displays the words registered in Japanese conversion.
  • /ch set default (player) (channel)-sets the destination of the specified player to the specified channel.
  • /ch reload-reload config.yml.
  • /jp (name) off-Turns off chat Japanese translation for the specified player.
  • /jp (name) on-Turns on chat Japanese translation for the specified player.
  • /ch invite (name) force [channel]-Forces the specified person to join the channel chat. You need "lunachat-admin.force-invite" permission to execute force.

Message format details

The /ch format (format) command allows you to specify the message format for channel chat.

The following keywords can be set in the format.

  • %ch-Channel name
  • %color-Channel color (white if not set)
  • %displayname-Display name of the speaking player
  • %player-Player name of the player who spoke
  • %server-Speaker's connection server name (valid when installed on the BungeeCord side)
  • %world-Name of the world that said
  • %prefix-prefix (replaced if Vault and permission management plugins are installed)
  • %suffix-suffix (replaced if Vault and permission management plugin are installed)
  • %date-date
  • %time-time
  • %to-Name of the player with whom you are talking in the case of private
  • %0 ~ %9-Contents of template with corresponding ID
  • &?-Color code (? is 0-9a-f)
  • #??? or #??????-color code (? is 0-9a~f)
  • %msg-Message (content of statement)

The default message format is as follows.

&f[%color%ch&f]%prefix%displayname%suffix&a:&f %msg

Channel option details

You can specify channel options with the /ch option (key=value...) command.

The following options can be set.

  • description-Channel description
  • alias-An alias for the channel. If you set an alias, you can specify the alias to enter the room. You can remove the alias by leaving it empty.
  • password-Channel password (leave empty for no password authentication)
  • visible-Specify whether to display in the channel list with true/false
  • color-Specifies the channel color of the channel (can be used with keyword %color)
  • broadcast-Whether to set the channel to the broadcast channel (statements are displayed to all players), specified with true/false
  • range-Channel audible range specification Ignored if broadcast=false. It is ignored when introduced on the Bungee Cord side. Range=world will be a world chat, range=30 will be a 30-chat range chat.
  • allowcc-Whether to use the color code for the channel is specified with true/false. If set to false, color code (&?) will not be available for that channel.
  • japanize-Japanize conversion type for each channel. Specify with none/kana/googleime. By specifying empty (/ch option japanize=), conversion operation according to JapanizeType in config.yml will be resumed.

Specified example) /ch option description=A room with a password! password=12345 visible=true color=red

Channel moderator commands

The channel moderator is set to the person who first created the channel.

  • /ch invite (name)-Invite the specified person to join the channel chat.
  • /ch kick (name) [channel]-Kick the specified person from channel chat.
  • /ch ban (name) [channel]-BAN the specified person from channel chat.
  • /ch ban (name) [minutes]-BAN the specified person for the specified number of minutes.
  • /ch pardon (name) [channel]-Removes the BAN of the specified person.
  • /ch mute (name) [channel]-Mute the specified person from channel chat.
  • /ch mute (name) [minutes]-Mute the specified person for the specified number of minutes.
  • /ch unmute (name) [channel]-Unmute the specified person.
  • /ch remove-removes the channel.
  • /ch format (format)-sets the channel message format.
    It can be set with keywords. Details will be described later.
  • /ch moderator (player...)-set the moderator for the channel.
    You can specify multiple people at once. If you want to remove it from the moderator, please add a minus "-" before the name. Details will be described later.
  • /ch option (key=value...)-set options for the channel. Details will be described later.

Administrator command

  • /ch template (number) (template...)-Register a message format template.
    To use a template, write the template number after the replacement keyword % with the /ch format (format) command and set it.
  • /ch dictionary add (from) (to)-Add new contents to the word dictionary when converting to Japanese. /ch dictionary can be shortened to /ch dic. Specify the character string that replaces the word to be matched with from to. Execution example) /ch dic add google Google
  • /ch dictionary remove (word)-Removes the specified word from the word dictionary when converting to Japanese.
  • /ch dictionary view-Displays the words registered in Japanese conversion.
  • /ch set default (player) (channel)-sets the destination of the specified player to the specified channel.
  • /ch reload-reload config.yml.
  • /jp (name) off-Turns off chat Japanese translation for the specified player.
  • /jp (name) on-Turns on chat Japanese translation for the specified player.
  • /ch invite (name) force [channel]-Forces the specified person to join the channel chat. You need "lunachat-admin.force-invite" permission to execute force.

Message format details

The /ch format (format) command allows you to specify the message format for channel chat.

The following keywords can be set in the format.

  • %ch-Channel name
  • %color-Channel color (white if not set)
  • %displayname-Display name of the speaking player
  • %player-Player name of the player who spoke
  • %server-Speaker's connection server name (valid when installed on the BungeeCord side)
  • %world-Name of the world that said
  • %prefix-prefix (replaced if Vault and permission management plugins are installed)
  • %suffix-suffix (replaced if Vault and permission management plugin are installed)
  • %date-date
  • %time-time
  • %to-Name of the player with whom you are talking in the case of private
  • %0 ~ %9-Contents of template with corresponding ID
  • &?-Color code (? is 0-9a-f)
  • #??? or #??????-color code (? is 0-9a~f)
  • %msg-Message (content of statement)

The default message format is as follows.

&f[%color%ch&f]%prefix%displayname%suffix&a:&f %msg

Channel option details

You can specify channel options with the /ch option (key=value...) command.

The following options can be set.

  • description-Channel description
  • alias-An alias for the channel. If you set an alias, you can specify the alias to enter the room. You can remove the alias by leaving it empty.
  • password-Channel password (leave empty for no password authentication)
  • visible-Specify whether to display in the channel list with true/false
  • color-Specifies the channel color of the channel (can be used with keyword %color)
  • broadcast-Whether to set the channel to the broadcast channel (statements are displayed to all players), specified with true/false
  • range-Channel audible range specification Ignored if broadcast=false. It is ignored when introduced on the Bungee Cord side. Range=world will be a world chat, range=30 will be a 30-chat range chat.
  • allowcc-Whether to use the color code for the channel is specified with true/false. If set to false, color code (&?) will not be available for that channel.
  • japanize-Japanize conversion type for each channel. Specify with none/kana/googleime. By specifying empty (/ch option japanize=), conversion operation according to JapanizeType in config.yml will be resumed.

Specified example) /ch option description=A room with a password! password=12345 visible=true color=red

Details of channel moderator setting command

The moderator can be set with the /ch moderator (player...) command.

You can specify multiple moderators to set.

If you add a minus "-" before the name, you can revoke moderator authority.

  • Example 1) Add ucchy to the moderators (on the current default channel)

/ch moderator ucchy

  • Example 2) Add ucchy, lunasys, and pabook to the moderator

/ch moderator ucchy lunasys pabook

  • Example 3) Exclude ucchy from the moderator (ucchy becomes a general participant from the moderator).

/ch moderator -ucchy


List of permission nodes

lunachat permission node

command Permission Default permission settings
/ch join lunachat.join All players
/ch join (channel name) lunachat.join.(channel name) All players
/ch leave lunachat.leave All players
/ch leave (channel name) lunachat.leave.(channel name) All players
/ch list lunachat.list All players
/ch invite lunachat.invite All players
/ch accept lunachat.accept All players
/ch deny lunachat.deny All players
/ch kick lunachat.kick All players
/ch ban lunachat.ban All players
/ch pardon lunachat.pardon All players
/ch mute lunachat.mute All players
/ch unmute lunachat.unmute All players
/ch hide lunachat.hide All players
/ch unhide lunachat.unhide All players
/ch info lunachat.info All players
/ch log lunachat.log All players
/ch log (channel name) lunachat.log.(channel name) All players
/ch create lunachat.create All players
/ch remove lunachat.remove All players
/ch format lunachat.format All players
/ch moderator lunachat.moderator All players
/ch option lunachat.option All players
/tell lunachat.message All players
/r lunachat.reply All players
/jp on|off lunachat.japanize All players
Permission to use color code lunachat.allowcc All players
Channel permission to speak lunachat.speak.(channel name) All players
All privileges listed in this table lunachat.*

lunachat.option permission node

A node for permission to change channel option settings.

command Permission Default permission settings
/ch option description=... lunachat.option.description All players
/ch option alias=... lunachat.option.alias All players
/ch option color=... lunachat.option.color All players
/ch option broadcast=... lunachat.option.broadcast OP only
/ch option range=... lunachat.option.range OP only
/ch option password=... lunachat.option.password All players
/ch option visible=... lunachat.option.visible All players
/ch option allowcc=... lunachat.option.allowcc All players
/ch option japanize=... lunachat.option.japanize All players
All command permissions listed in this table lunachat.option.*

lunachat-admin authority node

command Permission Default permission settings
All moderator commands for all channels lunachat-admin.mod-all-channels OP only
Display the content of all channels
Set opListenAllChannel: true in config.yml.
lunachat-admin.listen-all-channels OP only
/ch template lunachat-admin.template OP only
/ch check lunachat-admin.check OP only
/ch dictionary lunachat-admin.dictionary OP only
/ch set lunachat-admin.set OP only
/ch reload lunachat-admin.reload OP only
/jp (name) on|off lunachat-admin.japanize-other OP only
/ch invite (player) force [channel] lunachat-admin.force-invite OP only
All command permissions listed in this table lunachat-admin.*