Author: w0w (me).
Current version: 2.0
Changelog:
Spoiler
- 2.0: A lot of fixes. Some code was separated. Now we have this plugin as a core with natives and forwards to create other plugins. Also, I added mj_set_user_jumps native.
- 1.0.1: mj_console_cmd_messages_mode was removed. Now use mj_console_cmd_messages. 0 - disabled; 1 - show messages only to who used the command and who has received multi jumps; 2 - show to everyone.
- 1.0:
- Removed AMX Mod X 1.8.2/1.8.3 support.
- Defines are replaced by CVars.
- Added automatic creation and execution of a configuration file with CVars: "amxmodx/configs/plugins/multi_jump.cfg".
- When buying multi jumps (if CVar mj_purchase_cmd = 1), they are no longer set but added to the current ones.
- New CVars: mj_trail, mj_trail_effect, mj_trail_life, mj_trail_size, mj_trail_brightness (copied from Easy Multijump).
- Added natives: mj_get_user_jumps(id), mj_give_user_jumps(id), mj_remove_user_jumps(id, amount).
- Added a forward: mjfwd_BuyMultiJumps(id) (called when a player buys multi jumps).
- 0.4: Fixed an error.
- 0.3: Fixed a compilation error when defines "MJ_BUY" and "MJ_CONSOLE_CMD" were commented.
- 0.2: Added a pause for a jump during a jump, that is, by scrolling the mouse wheel with a bind +jump in the air, if there are many jumps, they could immediately disappear (thanks to mx?!).
- 0.1: Release.
Requirements:- AMX Mod X 1.8.3 or higher.
- ReAPI module.
Multilingual support:- Russian (RU)
- English (EN)
- Spanish (ES)
- Turkish (TR): Snake.
Plugin has many features:
- If you want a player with a certain flag (mj_admin_access) to always have additional jumps (mj_additional_jumps), you cannot leave empty mj_additional_jumps (if it's empty that means that everyone has additional jumps). You need to have multi_jump_admin enabled to use that CVar.
- If you want to make automatically after the jump another one, you need to enable mj_auto_double_jump. If you use this setting and mj_additional_jumps is not empty then they are combined, that is, after your jump you will jump again automatically and be able to jump a specified number of times in mj_additional_jumps.
- You can give jumps to a player/team/everyone if the multi_jump_admin plugin is enabled, as well as indicate the time you want to give them out, that is, for example, you give 10 jumps for 10 seconds, if the player does not spend these 10 jumps in 10 seconds they will be removed. Moreover, you should pay attention that you don't need to stack time, that is, if you give 10 jumps for 10 seconds and immediately 10 jumps for 15 seconds, then after 10 seconds the jumps will be removed.
Examples of using the command:
If that CVar is enabled:- mj_admin_access: player with access flag/flags will be able to use free multi jumps (mj_additional_jumps).
- mj_admin_menu_access: player with access flag/flags will be able to use that command.
- mj_admin_cmd_messages: if you want to show messages in the chat after giving additional jumps to a player/team/everyone (0 - disabled; 1 - enabled).
- mj_admin_cmd_logs: if you want to log when admins give additional jumps to a player/team/everyone (0 - disabled; 1 - enabled).
- That's the format of a log: <player name of the player who gave> <Steam ID of the player who gave> <IP of the player who gave> -----> +number of given jumps -----> <player name of the player who received> <STeam ID of the player who received> <IP of the player who received>
- Other option is that multi jumps can be bought. mj_purchase_cmd is reponsible for that. If it's enabled, players will be able to buy n multi jumps (depending on the CVar mj_purchase_cmd_additional_jumps).
If the CVar is enabled:- mj_buy_price: price of n multi jumps.
- mj_buy_price_steam: price of n multi jumps for steam players. Only if you have Reunion.
DON'T CONFUSE mj_additional_jumps and mj_buy_additional_jumps.
- You can also remove users' jumps on spawn (mj_reset_jumps_spawn).
- If you want to have a trail after doing a multi jump you need to enable mj_trail.
If the CVar is enabled:- mj_trail_effect: color type of the trail.
- 0 - random trail color
- 1 - color of team of the player
- mj_trail_life: Life time of the trail
- mj_trail_size: Size of the trail
- mj_trail_brightness: Brightness of the trail
The config file is created automatically in "
amxmodx/configs/plugins" where you can set settings which you want.
Configuration file (multi_jump):
Spoiler
PHP Code:
// This file was auto-generated by AMX Mod X (v1.10.0.5248)
// Cvars for plugin "Multi Jump" by "w0w" (multi_jump.amxx, v2.0)
// Automatic double jump, that is, after the jump you jump again (0 / 1)
// -
// Default: "0"
// Minimum: "0.000000"
// Maximum: "1.000000"
mj_auto_double_jump "0"
// Velocity of the double jump (if mj_auto_double_jump = 1)
// -
// Default: "350.0"
// Minimum: "0.000000"
mj_auto_double_jump_velocity "350.0"
// Amount of additional jumps
// -
// Default: "1"
// Minimum: "1.000000"
mj_additional_jumps "1"
// Reset jumps on player spawn? (0 / 1)
// -
// Default: "1"
// Minimum: "0.000000"
// Maximum: "1.000000"
mj_reset_jumps_spawn "1"
// a trail after a multi jump (0 / 1)
// -
// Default: "1"
// Minimum: "0.000000"
// Maximum: "1.000000"
mj_trail "1"
// 0 - random trail color; 1 - color of team of the player
// -
// Default: "1"
// Minimum: "0.000000"
// Maximum: "1.000000"
mj_trail_effect "1"
// Life time of the trail
// -
// Default: "2"
// Minimum: "1.000000"
// Maximum: "25.000000"
mj_trail_life "2"
// Size of the trail
// -
// Default: "2"
// Minimum: "1.000000"
// Maximum: "255.000000"
mj_trail_size "2"
// Brightness of the trail
// -
// Default: "150"
// Minimum: "0.000000"
// Maximum: "255.000000"
mj_trail_brightness "150"
Configuration file (multi_jump_admin):
Spoiler
PHP Code:
// This file was auto-generated by AMX Mod X (v1.10.0.5248)
// Cvars for plugin "Multi Jump: Admin" by "w0w" (multi_jump_admin.amxx, v1.0)
// Admin access to use multi jumps. If it's empty so everyone can use
// -
// Default: "t"
mj_admin_access "t"
// Access to use the console command to give additional jumps to a player/team/everyone
// -
// Default: "l"
mj_admin_console_access "l"
// Show messages after giving multi jumps. 0 - disabled; 1 - show only to who used the command and who has received multi jumps; 2 - show to everyone
// -
// Default: "1"
// Minimum: "0.000000"
// Maximum: "1.000000"
mj_admin_messages "1"
// Logging when admins give additional jumps to a player/team/everyone. 0 - disabled; 1 - enabled
// -
// Default: "1"
// Minimum: "0.000000"
// Maximum: "1.000000"
mj_admin_logs "1"
Configuration file (multi_jump_buy):
Spoiler
PHP Code:
// This file was auto-generated by AMX Mod X (v1.10.0.5248)
// Cvars for plugin "Multi Jump: Buy" by "w0w" (multi_jump_buy.amxx, v1.0)
// Price of buying multi jumps
// -
// Default: "30"
// Minimum: "0.000000"
// Maximum: "2147483520.000000"
mj_buy_price "30"
// Price of buying multi jumps for steam players
// -
// Default: "20"
// Minimum: "0.000000"
// Maximum: "2147483520.000000"
mj_buy_price_steam "20"
// How many multi jumps will the player receive after the purchase
// -
// Default: "1"
// Minimum: "1.000000"
mj_buy_additional_jumps "1"
The plugin has some natives:
- mj_get_user_jumps(id): returns the number of jumps that a player has.
- mj_give_user_jumps(id, amount): gives to a player a specified number of jumps. Returns the number of given jumps on success, false otherwise.
- mj_set_user_jumps(id, amount): sets to a player a specified number of jumps. Returns the number of set jumps on success, false otherwise.
- mj_remove_user_jumps(id, amount): removes a specified number of jumps from a player. Returns the number of removed jumps on success.
Moreover, it has a forward:
mjfwd_BuyMultiJumps(id) which it's called when a player buys multi jumps.
Use
#include <multi_jump> to use natives and the forward from that plugin.
Official topic of the resource in: