🎮 Rappelz Tournament — free pet-based MMORPG, Epic 9.6+, no pay-to-win, online since 2016. Join 3,100+ players on Discord →
Rappelz GS Commands Reference — Epic 8.1 to 9.4
Complete reference for Rappelz GS commands covering Epic 8.1 through 9.4. Commands can be executed via console, LUA scripts or in-game chat depending on your permission level. Parameters shown in
[brackets] are optional. Use the search and category filters below to quickly find what you need.
Credits: Originally compiled by @InkDevil and @mongreldogg with contributions from the ElitePvP Rappelz community.
Sources: 9.4 GS Commands Thread · 8.1 GS Commands Discussion
Sources: 9.4 GS Commands Thread · 8.1 GS Commands Discussion
330
Commands
37
Categories
261
Documented
69
Unknown
Showing 330 of 330
Account-Flag(3 commands)
| Command | Parameters | Description |
|---|---|---|
| get_account_flag | (flag_name) | Returns the value of a named account-level flag for the calling character. |
| set_account_flag | (flag_name, value) | Sets or creates an account-level flag with the given name and value for the calling character. |
| del_account_flag | (flag_name) | Deletes a named account-level flag for the calling character. |
Auction(1 commands)
| Command | Parameters | Description |
|---|---|---|
| cancel_auction_by_seller | (character_id) | Cancels all active auction listings belonging to the specified player. |
Battle-Arena(12 commands)
| Command | Parameters | Description |
|---|---|---|
| do_each_player_in_battle_arena_instance | (arena_id, instance_no, script_text) | Runs a script for every player in the specified battle arena instance. |
| do_each_player_in_battle_arena_team | (arena_id, instance_no, team_no, script_text) | Runs a script for every player on a specific team in a battle arena instance. |
| get_battle_arena_block_time | (charname) | Returns how many seconds of battle arena lockout remain for the specified character. |
| set_battle_arena_block_time | (time_in_seconds, charname) | Sets the battle arena cooldown time for the specified character. |
| get_battle_arena_team_no | ([charname]) | Returns the team number assigned to the specified character in the current battle arena. |
| activate_battle_arena_prop | (parameters) | Unknown — likely activates an interactive object inside a battle arena. |
| set_battle_arena_instance_flag | (parameters) | Unknown — likely sets a flag value within a battle arena instance. |
| get_battle_arena_instance_flag | (parameters) | Unknown — likely returns a flag value from a battle arena instance. |
| get_battle_arena_penalty_count | (parameters) | Unknown — likely returns how many penalties a player has accumulated in arena. |
| set_battle_arena_penalty_count | (parameters) | Unknown — likely sets the penalty count for an arena player. |
| get_battle_arena_next_penalty_dec_time | (parameters) | Unknown — likely returns when the player's next penalty reduction occurs. |
| set_battle_arena_next_penalty_dec_time | (parameters) | Unknown — likely sets when the next penalty reduction will happen. |
Buff(11 commands)
| Command | Parameters | Description |
|---|---|---|
| add_state | (state_id, state_power, state_time [, charname]) | Applies a buff or debuff to a character using its state ID, power level and duration. |
| get_state_level | (state_id [, charname]) | Returns the current power level of an active state on the specified character. |
| remove_state | (state_id, state_power [, charname]) | Removes a specific buff or debuff from a character by matching its ID and power. |
| rs2 | () | Removes all temporary (non-permanent) buffs from the calling character. |
| add_cstate | (state_id, state_power, state_time [, charname]) | Applies a buff or debuff to the calling character's main summoned creature. |
| remove_cstate | (state_id, state_power [, charname]) | Removes a specific state from the calling character's main summoned creature. |
| add_event_state | (state_id, state_power) | Applies a server-wide buff to every player currently online. Stays active until manually removed. |
| remove_event_state | (state_id, state_power) | Removes a previously applied server-wide buff by matching its ID and power. |
| clear_event_state | () | Removes all currently active server-wide event buffs at once. |
| get_event_state_list | () | Returns a text list of all currently active server-wide buffs, showing each ID and power level. |
| cast_world_state | (state_id, state_level, state_time) | Applies a timed buff to all players currently online. Expires automatically after the given duration. |
Channel(5 commands)
| Command | Parameters | Description |
|---|---|---|
| get_proper_channel_num | (parameters) | Unknown — likely returns the recommended channel number for a player. |
| get_min_channel_num | (parameters) | Unknown — likely returns the lowest available channel number. |
| get_max_channel_num | (parameters) | Unknown — likely returns the highest available channel number. |
| get_user_count_in_channel | (parameters) | Unknown — likely returns how many players are in a specific channel. |
| get_layer_of_channel | (parameters) | Unknown — likely returns the map layer associated with a channel. |
Character-Flag(3 commands)
| Command | Parameters | Description |
|---|---|---|
| get_flag | (flag_name) | Returns the value of a character flag stored in the character's flag list. |
| set_flag | (flag_name, value) | Creates or updates a flag in the character's flag list with the specified value. |
| del_flag | (flag_name) | Deletes a named flag from the character's flag list. Flags are stored in the flag_list column of dbo.Character with a maximum of 1024 entries. |
Control(20 commands)
| Command | Parameters | Description |
|---|---|---|
| kick | ([charname]) | Disconnects and removes a character from the server. |
| stat | (charname) | Prints the character's name, the client's IP address and their current in-game coordinates. Only works if the character is online. |
| kill_target | ([charname]) | Instantly kills the current target of the specified character. |
| set_invisible | (value [, name]) | Toggles a character's visibility. Use 1 to make them invisible, 0 to make them visible again. |
| get_os_time | (<table>) | Returns the current system time as seconds elapsed since 01 January 1970 00:00 UTC (Unix timestamp). |
| get_os_date | () | Returns the current system date as a formatted text string. |
| get_minute | () | Returns how many minutes remain until the next full hour on the game server. |
| cs | () | Calculates the distance between the calling character and their current target. |
| gametime | () | Returns the current server engine time from the 'engine.ar_time' environment variable. |
| set_auto_user | (value, character_handle) | Marks a character as an auto-user (suspected bot). Setting value to 1 applies the bot penalty (teleport to abyss + debuff). Setting it to 0 removes it. |
| sconv | (text [, text, text…]) | Concatenates multiple client-side string references and text values together following the client string format. |
| set_auto_account | (parameters) | Unknown — likely marks an account as automated or restricted. |
| clear_auto_account | (parameters) | Unknown — likely clears the automated account status. |
| set_chat_block_time | (charname, time) | Mutes a character for the specified number of minutes. |
| set_pcbang_user | (parameters) | Unknown — likely assigns PC Bang (internet cafe) status to a user. |
| set_continuous_play_time | (parameters) | Unknown — likely tracks or adjusts continuous play session time. |
| get_user_count_near | (parameters) | Unknown — likely returns how many players are nearby. |
| tt | (parameters) | Unknown command. |
| is_changeable_job | (parameters) | Unknown — likely checks whether a character is eligible for a class change. |
| set_account_authority | (parameters) | Unknown — likely sets the permission level for an account. |
Creature(13 commands)
| Command | Parameters | Description |
|---|---|---|
| insert_summon_by_summon_id | (summon_id) | Unknown — likely adds a creature to the character's possession using the summon ID from SummonResource. |
| insert_summon | (parameters) | Unknown — likely adds a creature to the character's creature list. |
| insert_summon_by_monster_id | (parameters) | Unknown — likely adds a creature using a monster ID rather than a summon ID. |
| creature_evolution | (handle) | Advances a creature to its next evolution stage. Returns 1 if successful. |
| creature_enhance | (slot, enhance) | Applies a specified enhancement value to a creature in a given formation slot. Slot numbering starts at 0. |
| get_creature_handle | (form_slot [, charname]) | Returns the handle of the creature occupying the specified formation slot. Slot numbering starts at 0. |
| get_creature_name_id | (creature_handle) | Returns the name_id string from SummonResource for the creature with the given handle. |
| creature_name_change_box | (creature_handle [, charname]) | Shows the creature name change dialog to the specified character for the given creature. |
| reset_summon_skill | (creature_handle) | Resets all learned skills on the specified creature. |
| fix_summon_jp | (parameters) | Unknown — likely corrects or recalculates job point values for a creature. |
| get_summon_name_id | (parameters) | Unknown — likely returns the name ID of a creature. |
| get_summon_rate | (summon_ID) | Returns the taming rate for a creature as defined in SummonResource. |
| get_summon_list | (parameters) | Unknown — likely returns a list of all creatures owned by a character. |
Creature-Farm(8 commands)
| Command | Parameters | Description |
|---|---|---|
| show_creature_farm_window | ([charname]) | Opens the creature farm interface for the specified character. |
| get_farmed_summon_list | (parameters) | Unknown — likely returns a list of creatures currently in the farm. |
| get_farmed_summon_count | (parameters) | Unknown — likely returns how many creatures are currently in the farm. |
| get_farmed_summon_value | (parameters) | Unknown — likely returns a stat value from a farmed creature. |
| get_farmed_summon_level | (parameters) | Unknown — likely returns the level of a farmed creature. |
| farm_summon | (parameters) | Unknown — likely sends a creature to the farm. |
| regain_summon | (parameters) | Unknown — likely retrieves a creature back from the farm. |
| nurse_summon | (parameters) | Unknown — likely triggers a healing or recovery action for a farmed creature. |
Creature-Value(8 commands)
| Command | Parameters | Description |
|---|---|---|
| set_creature_value | (handle, type, value) | Sets a specific property in a creature's data structure using its handle. |
| scv | (handle, type, value) | Shorthand for set_creature_value. |
| smcv | (type, value [, charname]) | Sets a property value on the main summoned creature of the specified character. |
| get_creature_value | (handle, type) | Returns a specific property from a creature's data structure by its handle. Returns as a 32-bit integer. |
| gcv | (handle, type) | Shorthand for get_creature_value. |
| gmcv | (type [, charname]) | Returns a property value from the main currently summoned creature of the specified character. |
| emcv | (type [, charname]) | Works like gmcv but also prints the result in the format: '* type: value'. |
| change_creature_name | (creature_handle, name) | Renames a creature identified by its handle. |
Dungeon(15 commands)
| Command | Parameters | Description |
|---|---|---|
| enter_dungeon | (dungeon_id [, charname]) | Transports the specified character (or the caller if no name given) into the dungeon with the matching ID. |
| enter_secret_dungeon | (dungeon_id) | Sends the calling character into the secret dungeon linked to the specified dungeon ID. |
| drop_dungeon_owner_ship | () | Removes the calling character's guild ownership of a dungeon they currently own. |
| change_dungeon_owner | (dungeon_id, guild_id) | Forces ownership of the specified dungeon to transfer to the given guild. |
| clear_dungeon_core_guardian | (parameters) | Unknown — likely clears the guardian creatures from a dungeon core. |
| get_own_dungeon_id | ([charname]) | Returns the ID of the dungeon owned by the guild the specified character belongs to. |
| get_siege_dungeon_id | ([charname]) | Returns the ID of the dungeon currently under siege by the guild the specified character belongs to. |
| get_tax_rate | (dungeon_id) | Returns the current gold and Lak tax rate (as a percentage) for the specified dungeon. |
| set_tax_rate | (dungeon_id, percents) | Sets the tax rate for gold and Lak on the specified dungeon. Range is 1–10%. Only works if the caller is the dungeon-owning guild leader. Requires tax_rate_adjust() to take effect. |
| get_tax_amount | () | Returns how much gold has been collected through dungeon tax. |
| get_tax_chaos_amount | () | Returns how much Lak has been collected through dungeon tax. |
| draw_tax | () | Transfers all taxed gold from the dungeon counter to the caller's gold balance. Requires save() or update_gold_chaos() afterwards. Returns 0 if nothing to collect or if access is denied. |
| draw_tax_chaos | () | Transfers all taxed Lak from the dungeon counter to the caller's Lak balance. Requires save() or update_gold_chaos() afterwards. |
| get_dungeon_relation | (dungeon_id) | Returns the relationship type between the calling character's guild and the specified dungeon. |
| get_own_guild_name | (dungeon_id) | Returns the name of the guild that owns the dungeon with the given ID. |
Environment-Variables(3 commands)
| Command | Parameters | Description |
|---|---|---|
| get_env | (env_name) | Returns the value of a server environment variable. These are stored in .eop configuration files. |
| env | (environmental_variable) | Shorthand alias for get_env. |
| set_env | (env_name, value) | Creates or updates a server environment variable in memory. |
Event(13 commands)
| Command | Parameters | Description |
|---|---|---|
| refresh_event_drop | ([id]) | Reloads event item drop data for a specific ID, or refreshes the entire drop table if no ID is given. |
| start_event_drop | (ID) | Activates an event item drop using the ID defined in EventItemDropInfo. |
| stop_event_drop | (ID) | Stops an active event item drop by its ID. |
| start_event_dungeon_droprate | () | Activates the dungeon drop rate multiplier defined in dbo.EventDungeonDropRate. |
| stop_event_dungeon_droprate | () | Deactivates the event dungeon drop rate multiplier. |
| refresh_event_dungeon_droprate | (parameters) | Unknown — likely reloads the event dungeon drop rate table. |
| event_supply | (parameters) | Unknown — likely triggers a supply delivery event. |
| refresh_event_supply | (parameters) | Unknown — likely reloads supply event data. |
| start_event_supply | (parameters) | Unknown — likely starts a supply item distribution event. |
| stop_event_supply | (parameters) | Unknown — likely stops an active supply event. |
| supply_event_item | (parameters) | Unknown — likely distributes an item to players as part of a supply event. |
| set_event_area_enter_count | (event_area_id, count) | Sets how many times a character can enter a specific event area. |
| get_event_area_enter_count | (event_area_id) | Returns how many times the calling character has entered the specified event area. |
Fieldprop(1 commands)
| Command | Parameters | Description |
|---|---|---|
| add_field_prop | (prop_id, time, x, y, layer, offset, rotate_x, rotate_y, rotate_z, scale_x, scale_y, scale_z) | Spawns an interactive prop on the map with full control over position, rotation and scale. Props are defined in dbo.FieldPropResource. |
Global-Variables(3 commands)
| Command | Parameters | Description |
|---|---|---|
| set_global_variable | (variable_name, value) | Creates or updates a global variable in both server memory and the database. |
| get_global_variable | (variable_name) | Returns a global variable value from server memory. |
| del_global_variable | (variable_name) | Deletes a global variable from both server memory and the database. |
Guild(18 commands)
| Command | Parameters | Description |
|---|---|---|
| create_guild | (guild_name) | Attempts to create a new guild with the given name and assigns the calling character as its leader. |
| destroy_guild | (guild_id) | Permanently deletes the guild with the given ID. |
| show_guild_create | ([charname]) | Opens the guild creation window for the specified character. |
| show_alliance_create | ([charname]) | Opens the alliance creation window for the specified character. |
| force_change_guild_name | (guild_id, new_name) | Forcibly renames the specified guild to the given new name. |
| force_promote_guild_leader | (guild_id, character_id) | Forcibly transfers guild leadership to the specified character. |
| check_valid_guild_name | (guild_name) | Checks whether the given string is a valid guild name. |
| create_alliance | (alliance_name) | Creates an alliance with the given name and sets the calling character's guild as its leader. |
| destroy_alliance | () | Attempts to dissolve the alliance that the calling character belongs to. |
| check_valid_alliance_name | (alliance_name) | Validates whether the given string can be used as an alliance name. Returns 2 or 4 if valid. |
| is_guild_leader | ([charname]) | Checks whether the character is their guild's leader. Returns 1 if true, 0 if false. |
| set_guild_block_time | (value [, charname]) | Sets the guild join lockout duration in seconds for the specified character. |
| get_guild_block_time | ([charname]) | Returns how many seconds remain before the guild entry block expires for the specified character. |
| is_alliance_leader | ([charname]) | Returns 1 if the character is an alliance leader, or 0 if not. |
| increase_max_alliance_member_count | (parameters) | Unknown — likely raises the maximum number of members allowed in an alliance. |
| get_max_alliance_member_count | (parameters) | Unknown — likely returns the current alliance member cap. |
| update_guild_info | (parameters) | Unknown — likely refreshes cached guild information. |
| update_guild_banner_info | (parameters) | Unknown — likely updates the stored guild banner data. |
HV-Pass(1 commands)
| Command | Parameters | Description |
|---|---|---|
| set_secroute_free_pass | (1, time [, charname]) | Sets the duration of a character's HV Pass. Time is specified in milliseconds. |
Instance-Dungeon(20 commands)
| Command | Parameters | Description |
|---|---|---|
| enter_instance_dungeon | (instance_dungeon_id [, charname]) | Teleports a character into a specific instance dungeon and triggers the dungeon's entry scripts. |
| enter_other_instance_dungeon | (dungeon_id, floor, next_floor, current_item_count, next_item_count) | Shows a dialog letting the player choose to stay on the current floor or advance to the next one. Used in multi-floor dungeons such as Volcanus. |
| leave_instance_dungeon | (instance_dungeon_id) | Shows a confirmation window asking the player if they want to exit the instance dungeon. |
| quit_instance_dungeon | (instance_dungeon_id [, charname]) | Instantly teleports the character to their revival position if they are currently inside the specified instance dungeon. |
| get_instance_dungeon_id | ([charname]) | Returns the instance dungeon ID of the dungeon the character is currently inside. |
| get_instance_dungeon_type_id | (instance_dungeon_id, layer) | Returns the type ID for a specific instance dungeon on a given layer. |
| set_instance_dungeon_flag | (instance_dungeon_id, layer, flag_name, value) | Sets a named flag value within a specific layer of an instance dungeon. |
| get_instance_dungeon_flag | (instance_dungeon_id, layer, flag_name) | Returns the value of a named flag from a specific layer of an instance dungeon. |
| get_alive_instance_respawn_group_monster_count | (instance_dungeon_id, layer, respawn_group) | Returns how many monsters from a specific respawn group are still alive in the given instance dungeon layer. |
| do_each_player_in_instance_dungeon | (instance_dungeon_id, layer, script_text) | Runs a script once for every player present in the specified instance dungeon layer. |
| send_mission_title | (text, charname) | Displays a mission title window to the player. Clears the window if text is empty. |
| send_mission_reward | (text, charname) | Shows a mission reward popup to the specified player. |
| send_mission_objective | (status_id, max_value, text, name) | Creates or updates a mission objective display for the player. |
| send_mission_objective_progress | (status_id, value, name) | Updates the progress value shown in the mission objective window. |
| broadcast_mission_title | (1, text, instance_id, layer) | Sets or updates the mission title shown to all players in the specified instance layer. |
| broadcast_mission_reward | (1, text, instance_id, layer) | Sets or updates the mission reward display for all players in the specified instance layer. |
| broadcast_mission_objective | (1, status_id, max_value, text, instance_id, layer) | Sets a mission objective for all players in the specified instance layer. |
| broadcast_mission_objective_progress | (1, status_id, value, instance_id, layer) | Updates the mission objective progress bar shown to all players in the specified instance layer. |
| broadcast_notice | (instance_type, text, instance_id [, layer [, team]]) | Sends a notice to all players in a specific instance. Use instance_type 1 for instance dungeons or 2 for battle arenas. For arenas, instance_id is the arena_id and team specifies which team receives the message. |
| add_instance_dungeon_monster | (parameters) | Unknown — likely spawns a monster inside an active instance dungeon. |
Item(47 commands)
| Command | Parameters | Description |
|---|---|---|
| insert_item | (item_id, item_count [, item_enhance, item_level, item_flag]) | Adds an item with the specified properties to the calling character's inventory. |
| insert_item_target | (item_id, item_count [, item_enhance, item_level, item_flag]) | Adds an item with the specified properties directly to the currently targeted character's inventory. |
| insert_item_near | (item_id, item_count [, item_enhance, item_level, item_flag]) | Adds an item to all players standing near the selected target. |
| insert_item_all | (parameters) | Unknown — likely adds an item to all players on the server. |
| delete_item | (item_handle, count) | Removes a specified number of an item (identified by its handle) from the calling character's inventory. |
| putoff_item | (item_handle) | Unequips the item identified by the given handle. |
| is_erasable_item | (item_handle) | Checks whether a specific item can be destroyed or erased from the inventory. Returns a true/false value. |
| find_item | (item_code) | Counts how many of a specific item the calling character has in their inventory. Returns the total count. |
| drop_item | (X, Y, layer, item_id, count) | Drops a given number of an item onto the ground at the specified map coordinates. |
| drop_gold | (X, Y, count) | Drops a specified amount of gold on the ground at the given coordinates. |
| insert_gold | (count [, charname]) | Adds a specific amount of gold to a character. If no name is given, it adds to the caller's account. |
| has_item | (item_code [, charname]) | Checks whether a character has a specific item in their inventory. Returns a true/false value. |
| get_item_handle | (item_code) | Returns the handle of the first matching item found in the calling character's inventory. |
| get_item_handle_list | (item_code) | Returns a list (table) of handles for every item matching the given code in the caller's inventory. |
| get_item_name | (item_handle) | Returns the display name of the item with the specified handle as a text string. |
| get_item_code | (item_handle) | Returns the item code for the given item handle. |
| get_item_level | (item_handle) | Returns the current level of the specified item. |
| set_item_level | (item_handle, value) | Sets the level of the specified item to the given value. |
| set_item_enhance | (item_handle, value) | Sets the enhancement level of the specified item. |
| set_item_enhance_fail | (item_handle) | Applies a failed enhancement state to the specified item, effectively breaking it. |
| get_item_enhance | (item_handle) | Returns the current enhancement level of the specified item. |
| get_item_grade | (item_handle) | Returns the grade of the specified item. |
| get_item_rank | (item_handle) | Returns the rank of the specified item. |
| get_item_price | (item_handle) | Returns the shop price of the specified item. |
| get_item_endurance | (item_handle) | Returns the remaining endurance time of a time-limited item. |
| set_item_endurance | (item_handle, time) | Sets the remaining endurance time for a time-limited item. |
| get_socket_info | (item_handle, socket_num) | Returns the value stored in a specific socket slot of an item (socket_num corresponds to the socket position). |
| set_socket_info | (item_handle, socket_num, socket_value) | Writes a value to a specific socket slot on an item. Use 0–3 for soul stone sockets and 1–5 for belt sockets. |
| set_item_element | (item_handle, shard_code) | Applies an elemental shard to the specified item using the shard's item code. |
| set_item_element_parameter | (item_handle, type, value) | Adds bonus elemental damage to an item. Type 1 sets physical attack, type 2 sets magic attack. |
| get_item_name_by_code | (item_code) | Returns the display name of an item using its item code rather than its handle. |
| get_item_name_id | (item_code) | Returns the name_id entry from the ItemResource database table for the given item code. |
| get_wear_item_handle | (wear_type) | Returns the handle of whichever item the calling character currently has equipped in the specified slot. Slot types are defined in the wear_type column of ItemResource. |
| get_item_appearance_code | (item_handle) | Returns the appearance/skin ID of the specified item. |
| set_item_appearance_code | (item_handle, new_shape_item_id) | Changes the visual appearance of an item to match a different item's look. |
| insert_awaken | (item_handle, 5, 5) | Applies 5 random awakening stat bonuses to the specified piece of equipment. |
| delete_awaken | (item_handle) | Removes all awakening stat bonuses from the specified item. |
| identify_item | (item_handle, preset_id) | Identifies an unidentified item using a specific stat preset. |
| change_item_code | (item_handle, new_item_code) | Replaces the item's current code with a new one, effectively converting it into a different item. |
| get_item_random_option | (item_handle, effect_line) → [1=effect_type, 2=opt_type, 3=opt_value] | Unknown — returns the random option data for a given line on an identified item. |
| set_item_random_option | (item_handle, effect_line, effect_type, opt_type, opt_value) | Manually sets a custom random bonus effect on a specific line of an identified equipment piece. |
| pick_item_in_drop_group | (dropgroup_id) | Simulates a roll on a drop group and returns a table containing a random item and quantity based on that group's drop table. |
| get_item_ethereal_durability | (item_handle) | Returns the current durability value of an item. |
| set_item_ethereal_durability | (item_handle, durability) | Sets the durability of an item to the specified value. |
| get_max_item_ethereal_durability | (item_handle) | Returns the maximum possible durability for the specified item. |
| clear_inventory | () | Completely empties the calling character's inventory. |
| equip_summon_card | (card_item_code [, charname]) | Moves the first tamed creature card matching the given code into the character's formation slot. |
Job(3 commands)
| Command | Parameters | Description |
|---|---|---|
| set_job | (parameters) | Unknown — likely assigns a job or class to a character. |
| reset_job | (parameters) | Unknown — likely resets a character's job or class assignment. |
| set_race | (race_id [, charname]) | Sets the race of the specified character. Use 3 for Gaia, 4 for Deva, 5 for Asura. |
Location(1 commands)
| Command | Parameters | Description |
|---|---|---|
| call_lc_In | (parameters) | Unknown — likely triggers a location change or area entry event. |
Market(1 commands)
| Command | Parameters | Description |
|---|---|---|
| open_market | (market_name [, charname]) | Opens the specified market interface for the character. |
Message(4 commands)
| Command | Parameters | Description |
|---|---|---|
| private_notice | (text) | Shows a notification message only to the calling character. |
| announce | (text) | Broadcasts a server-wide notice to all players displayed in green text. |
| whisper | (charname, text) | Sends a private message to a specific character, visible only to them. |
| message | (text) | Prints a text message directly to the calling character. |
Monster(20 commands)
| Command | Parameters | Description |
|---|---|---|
| add_npc | (x, y, npc_id, count [, lifetime, layer]) | Spawns one or more monsters at specific coordinates. These do not respawn after death. Returns an array of handles. |
| respawn | (spawn_id, interval, x_min, y_min, x_max, y_max, monster_id, min_count, max_count) | Creates a monster spawn point that places monsters randomly within the given coordinate rectangle at the specified interval. |
| respawn_rare_mob | (roaming_id, interval, x, y, mob_id, count, is_wandering) | Spawns a rare monster on the map. Only works during server initialization — must be called from the on_server_init() function. |
| respawn_roaming_mob | (roaming_id, monster_id, direction, distance [, reaction_interval]) | Spawns a roaming monster that follows a set path based on its roaming ID. |
| set_random_respawn | (random_respawn_id, interval, random_area_id, inc, is_wandering, way_point_id, prespawn_count, except_raid_siege) | Creates a randomised monster spawn across one or more defined areas. is_wandering: 1 = moves, 0 = stationary. prespawn_count: 1 = spawns immediately then starts timer, 0 = waits for first interval. |
| add_random_area | (random_spawn_id, min_x, min_y, max_x, max_y) | Defines a rectangular spawn area for use with set_random_respawn. Multiple areas can share the same ID — monsters will appear randomly across all of them. |
| add_random_monster | (random_spawn_ID, monster_ID, ratio) | Adds a monster type to a random spawn list with a specific spawn probability. Ratio is expressed as a decimal where 1% = 1,000,000. |
| add_random_monster_group | (parameters) | Unknown — likely adds a group of monsters to a random spawn list. |
| respawn_near_monster | (monster_handle, spawn_monster_id, count) | Spawns a given number of monsters near an existing monster identified by its handle. |
| monster_skill_cast | (skill_id, monster_handle, target_handle) | Forces a monster to cast a specific skill at a designated target. |
| get_monster_skill_target_position | (parameters) | Unknown — likely returns the position of a monster's skill target. |
| set_monster_skill_target_position | (parameters) | Unknown — likely sets the position of a monster's skill target. |
| set_next_attackable_time | (delay, monster_handle) | Sets a delay (in milliseconds) before the specified monster resumes attacking. |
| get_monster_id | (monster_handle) | Returns the monster ID for a given monster handle. |
| force_monster_proc_dead | (parameters) | Unknown — likely forces a monster to trigger its death processing. |
| add_way_point | (parameters) | Unknown — likely adds a waypoint to a monster's movement path. |
| set_way_point_type | (parameters) | Unknown — likely sets the type of movement behaviour at a waypoint. |
| set_way_point_speed | (parameters) | Unknown — likely sets the movement speed at a specific waypoint. |
| raid_respawn | (parameters) | Unknown — likely handles monster respawning during raid events. |
| raid_respawn_rare_mob | (parameters) | Unknown — likely handles rare mob respawning during raids. |
NPC(6 commands)
| Command | Parameters | Description |
|---|---|---|
| get_npc_id | () | Used inside NPC contact scripts. Returns the ID of the NPC the player is currently talking to. |
| get_npc_name | () | Returns the name text ID of the last NPC the player contacted. |
| get_npc_type | () | Returns the type text ID of the last NPC the player contacted. |
| get_npc_handle | ([charname]) | Returns the handle of the last NPC contacted by the specified player. |
| find_npc | () | Searches for an NPC and returns its handle. |
| add_npc_to_world | (x, y, npc_id) | Spawns an NPC at the specified map coordinates. |
NPC-Contact(8 commands)
| Command | Parameters | Description |
|---|---|---|
| dlg_title | (title_string) | Sets the title text shown in the NPC contact dialog window. |
| dlg_text | (text) | Sets the main body text in the NPC dialog. Must be called after dlg_title and before dlg_menu. |
| dlg_menu | (menu_text, script_text) | Adds a clickable menu option to the NPC dialog. The script_text runs when the player clicks that option. |
| dlg_show | () | Displays the NPC dialog window built with dlg_title, dlg_text and dlg_menu. |
| dlg_text_without_quest_menu | (text) | Shows NPC dialog text without including it in the NPC's standard menu options. |
| dlg_general | (text) | Shows a plain text message box to the calling character. |
| dlg_special | (window_type, confirm_script, text) | Shows a message window with a confirmation button. The confirm_script runs when the player clicks confirm. |
| quest_text_without_quest_menu | (parameters) | Unknown — similar to dlg_text_without_quest_menu but specifically for quest dialogs. |
PK(1 commands)
| Command | Parameters | Description |
|---|---|---|
| set_pk_mode | (value [, charname]) | Enables or disables PK mode for a character. 0 = off, 1 = on. |
Quest(12 commands)
| Command | Parameters | Description |
|---|---|---|
| force_start_quest | (quest_id, quest_description_string) | Starts a quest while ignoring existing progress state. |
| end_quest | (quest_id, reward_id [, charname]) | Attempts to complete a quest and give the specified reward to the named character. |
| drop_quest | (quest_id [, charname]) | Removes the specified quest from the character's active quest list. |
| quest_info | (quest_id, description_string_id [, charname]) | Shows quest details with the given description text to the specified character. |
| get_quest_progress | (quest_id [, charname]) | Returns the current progress state of a quest: -1 = does not exist, 0 = not started, 1 = in progress, 2 = reward available, 100 = abandoned, 255 = already completed. |
| get_quest_status | (quest_id, status_id [, charname]) | Returns the value of a specific status entry for the given quest. |
| set_quest_status | (quest_id, status_id, value [, charname]) | Sets a specific status value for the given quest. Status fields are defined in dbo.Quest as statusX columns. |
| get_last_accept_quest | ([charname]) | Returns the ID of the most recently accepted quest for the specified character. |
| reset_finished_quest | (quest_id) | Wipes all completion data for a quest and allows the calling character to start it again from the beginning. |
| start_quest | (parameters) | Unknown — likely starts a quest for the calling character. |
| add_pending_quest | (parameters) | Unknown — likely adds a quest to a pending or pre-accepted queue. |
| show_quest_info_without_npc | (parameters) | Unknown — likely shows quest information without requiring an NPC interaction. |
Server(12 commands)
| Command | Parameters | Description |
|---|---|---|
| ss | () | Retrieves all stored values for the calling character from the dbo.Character database table. |
| saveall | () | Saves all data currently held in server memory to the database. |
| save | ([charname]) | Saves the data of the specified character (or the caller if no name given) to the database. |
| shutdown | (countdown [, need_dump]) | Shuts down the server after the countdown delay. If need_dump is set to 1, a crash dump file is created in the process. |
| refresh | ([refresh_type]) | Reloads specified data from the database. Supports: allowed_commands_list, item, quest, monster, skill, script, string, scheduled_command. |
| update_gold_chaos | ([charname]) | Forces the database to update with the character's current gold and Lak balances. |
| get_server_category | () | Returns the current server category identifier. |
| get_local_info | () | Returns local server configuration and status information. |
| db_trace_dump | () | Generates a database query trace log file in the Log folder, named DB_Debug_year-month-day.log. |
| suicide | () | Crashes the game server. Use with extreme caution. |
| force_unregister_account | (account_name) | Removes a player's account from server memory. Does not affect any database tables. |
| delete_block_account | (parameters) | Unknown — likely removes an account block or ban. |
Siege-Raid(8 commands)
| Command | Parameters | Description |
|---|---|---|
| is_in_siege_dungeon | (parameters) | Unknown — likely checks whether the calling character is currently inside a siege dungeon. |
| respawn_guardian_object | (parameters) | Unknown — likely respawns a guardian object inside a siege dungeon. |
| show_dungeon_stone | (dungeon_id [, charname]) | Opens the dungeon stone menu for the specified dungeon to the named character. |
| change_tactical_position_owner | (parameters) | Unknown — likely transfers control of a tactical position within a siege to a different guild. |
| request_dungeon_raid | (parameters) | Unknown — likely sends a raid request for a dungeon. |
| cancel_dungeon_raid | (parameters) | Unknown — likely cancels an active or pending dungeon raid. |
| respawn_guardian | (dungeon_id, guardian_type, interval, x, y, mob_id, count, is_wandering) | Respawns a siege dungeon guardian. Type 0 = Core, 1 = Control Unit 1, 2 = Control Unit 2. |
| respawn_environmental_guardian | (dungeon_id, guardian_type, interval, x, y, mob_id, count, is_wandering) | Same as respawn_guardian — respawns siege dungeon environmental guardians. |
Skill(6 commands)
| Command | Parameters | Description |
|---|---|---|
| learn_skill | (skill_id) | Teaches the calling character a specific skill. If the skill is already known, it increases its level by 1. |
| learn_all_skill | ([charname]) | Teaches all available skills to a character and sets their level to 300. |
| learn_creature_all_skill | ([form_slot] [, charname]) | Teaches all skills to a creature in the given formation slot and raises it to the maximum level for its current evolution. Use 0 to affect all slots. |
| reset_skill | (job_level [, charname]) | Resets all skills for the specified job level. 0 = main class, 1 = first job, 2 = second job, 3 = master class. |
| creature_learn_skill | (skill_id, get_creature_value(creature_handle, 'handle'), charname) | Teaches a specific skill to the specified creature. |
| get_base_skill_level | (skill_id) | Returns the current level of the specified skill on the calling character. |
Soulstone(4 commands)
| Command | Parameters | Description |
|---|---|---|
| show_soulstone_craft_window | ([charname]) | Opens the soul stone crafting interface for the specified character. |
| get_item_soulstone_endurance | (item_handle) | Returns the remaining soul stone endurance on the specified item. |
| get_max_item_soulstone_endurance | (item_handle) | Returns the maximum soul stone endurance capacity for the specified item. |
| show_soulstone_repair_window | ([charname]) | Opens the soul stone repair interface for the specified character. |
Storage(1 commands)
| Command | Parameters | Description |
|---|---|---|
| open_storage | ([charname]) | Opens the character's warehouse storage window. |
Teleport(4 commands)
| Command | Parameters | Description |
|---|---|---|
| recall_player | (charname [, target_name]) | Instantly teleports the named character to the calling character's position without any confirmation. |
| recall_feather | (charname) | Prompts the specified character with a confirmation window. If they accept, they are teleported to the caller's location. |
| warp_to_revive_position | ([charname]) | Teleports a character to their saved revival coordinates stored in flags 'rx' and 'ry'. |
| warp_to_stored_position | ([charname]) | Teleports a character to their stored revival position (same as warp_to_revive_position). |
Title(8 commands)
| Command | Parameters | Description |
|---|---|---|
| open_title | (title_id [, charname]) | Unlocks all conditions required to earn a title but does not award the title itself. |
| achieve_title | (title_id [, charname]) | Completes all title requirements and awards the title to the specified character. |
| get_main_title | ([charname]) | Returns the ID of the character's currently equipped main title. |
| set_main_title | (title_id [, charname]) | Sets the specified title as the character's active main title. |
| get_sub_title | (slot [, charname]) | Returns the ID of the sub-title equipped in the specified slot. |
| set_sub_title | (slot, title_id [, charname]) | Equips a title into the specified sub-title slot. The title must already be in the character's achieved title list. Slots start at 0. |
| update_title_condition | (condition_type_id, value [, charname]) | Sets the progress value for a specific title unlock condition. |
| set_remain_title_time | (time_in_ms) | Updates the cooldown timer that controls how long before the main title can be changed again. |
Value(18 commands)
| Command | Parameters | Description |
|---|---|---|
| get_value | (type [, charname]) | Returns a specific stat or property value from the character's data structure. The 'type' parameter specifies which field to read. |
| gv | (type [, charname]) | Shorthand for get_value. Returns the same character stat or property. |
| add_value | (parameter, value [, charname]) | Adds the given amount to a specific character stat or property. |
| av | (parameter, value [, charname]) | Shorthand for add_value. |
| set_value | (parameter, value [, charname]) | Directly sets a specific character stat or property to the given value. |
| sv | (parameter, value [, charname]) | Shorthand for set_value. |
| echo_value | (type [, charname]) | Works like get_value but also prints the result to the console in the format: '* type: value'. |
| ev | (type [, charname]) | Shorthand for echo_value. |
| get_all_value | (charname) | Returns a full list of all stat types and their current values for the specified character. |
| get_target_value | (type [, charname]) | Returns a specific value from the current target of the named character. |
| gtv | (type [, charname]) | Shorthand for get_target_value. |
| get_handle_value | (handle, value_type) | Returns a specific property value from any object identified by its handle. |
| ghv | (handle, value_type) | Shorthand for get_handle_value. |
| add_exp_jp | (exp [, jp] [, charname]) | Adds experience points and optionally job points to a character. Use negative numbers to subtract. |
| setspeed | (value) | Sets the movement speed of the calling character. |
| set_level | (level [, charname]) | Sets the character level directly to the specified value. |
| set_huntaholic_point | (count [, charname]) | Sets the Huntaholic point total for the specified character. |
| add_chaos | (amount [, charname]) | Adds the specified amount of Lak (chaos currency) to a character. |
Window(8 commands)
| Command | Parameters | Description |
|---|---|---|
| open_url | (url, 0) | Opens a webpage directly in the calling character's browser window. URL is passed as a plain string, not an environment variable. |
| open_popup | (url_env_name, 1, 0) | Opens a browser popup for the calling character using a URL stored in an environment variable. |
| open_popup_and_set_size | (url, width, height, get, 0) | Opens a browser popup with custom width and height dimensions. |
| show_donation_prop | ([charname]) | Opens the Altar of the Goddess donation window for the specified character. |
| show_auction_window | ([charname]) | Opens the auction house window for the specified character. |
| show_huntaholic_lobby_window | ([charname]) | Opens the Huntaholic lobby window for the specified character. |
| show_channel_set | ([charname]) | Opens the channel selection window for the specified character. Channel IDs are stored in dbo.ChannelResource. |
| show_creature_dialog | ([charname]) | Opens the creature formation window for the specified character. |
No commands match your search.
Rappelz GS Commands — Frequently Asked Questions
What are Rappelz GS commands used for?
GS (Game Server / Game Sage) commands are administrative and scripting commands used to manage a Rappelz private server — spawning items, adjusting character stats, controlling dungeons, and running LUA-scripted server events. They are not available to regular players.
Are these Rappelz GS commands current for Epic 9.6?
This reference covers Epic 8.1 through 9.4, compiled by the ElitePvP community. Most core commands remain unchanged in later Epics, but always verify against your specific server’s LUA scripts before use.
What’s the difference between GS Commands and player Commands?
GS Commands (this page) are server-admin and scripting tools. For the commands regular players use in-game chat, see the Rappelz Commands guide instead.
Related Rappelz Guides
🟢 Server Online • 👥 3,100+ Discord Members • 🐉 200+ Tameable Pets • ⭐ No Pay-to-Win
Ready to Play?
Free to play since 2016 — Epic 9.6+, x400 EXP, active PvP and weekly events.