Initial release 1.0.0
Browse Source1.0.0 - Initial release.
Daemon666 committed
commit 2493c7634b3d801cb37100ccb7a215e5963843f6
4 changed files
with 223 additions and 0 deletions
A
CHANGELOG.md
+3 -0
A
README.md
+1 -0
A
addons/amxmodx/scripting/csb_checkpoints.sma
+162 -0
A
csb.json
+57 -0
CHANGELOG.md
A
| @@ -0,0 +1,3 @@ | ||
| 1 | +## 1.0.0 (2026-05-24) | |
| 2 | + | |
| 3 | +1.0.0 - Initial release. |
README.md
A
| @@ -0,0 +1 @@ | ||
| 1 | +<p><strong>CSB Checkpoints</strong> is a lightweight climb/KZ checkpoint system. <code>/cp</code> saves your origin, view angles and velocity, <code>/tp</code> teleports you back to the last point with <code>set_pev</code> + <code>EngFunc_SetOrigin</code>, and <code>/gocheck</code> cycles through every point saved on the current map. A cvar can require you to be on the ground to save, so you cannot store a mid-air cheat spot, and a chat counter shows how many points are stored.</p><p>Inspired by KZ / climb checkpoint plugins. Independent GPL re-implementation.</p><h2>Features</h2><ul><li><code>/cp</code>, <code>/tp</code>, <code>/gocheck</code> and <code>/clearcp</code>.</li><li>Stores origin, angles and velocity per point (up to 8, oldest dropped).</li><li><code>csb_cp_groundonly</code> forbids saving in the air.</li><li>Points are per-player and reset on map change.</li></ul><h2>Installation</h2><ol><li>Enable the <code>fakemeta</code> module in <code>modules.ini</code>.</li><li>Compile <code>csb_checkpoints.sma</code>, copy it to <code>addons/amxmodx/plugins/</code> and add it to <code>plugins.ini</code>.</li><li>Change the map.</li></ol> |
addons/amxmodx/scripting/csb_checkpoints.sma
A
| @@ -0,0 +1,162 @@ | ||
| 1 | +/* | |
| 2 | + * CSB Checkpoints | |
| 3 | + * Copyright (C) 2026 counter-strike-boost.com | |
| 4 | + * | |
| 5 | + * A lightweight KZ-style checkpoint system. /cp saves the player's origin, | |
| 6 | + * angles and velocity, /tp teleports back to the last saved point with | |
| 7 | + * set_pev + EngFunc_SetOrigin, and /gocheck cycles through every point saved on | |
| 8 | + * the current map. A cvar can force saving only while on the ground, and a HUD | |
| 9 | + * counter shows how many points are stored. | |
| 10 | + * | |
| 11 | + * Inspired by KZ / climb checkpoint plugins. Independent GPL re-implementation. | |
| 12 | + * | |
| 13 | + * This program is free software: you can redistribute it and/or modify it under | |
| 14 | + * the terms of the GNU General Public License as published by the Free Software | |
| 15 | + * Foundation, either version 3 of the License, or (at your option) any later | |
| 16 | + * version. It is distributed in the hope that it will be useful, but WITHOUT | |
| 17 | + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS | |
| 18 | + * FOR A PARTICULAR PURPOSE. See <https://www.gnu.org/licenses/> for details. | |
| 19 | + */ | |
| 20 | + | |
| 21 | +#include <amxmodx> | |
| 22 | +#include <fakemeta> | |
| 23 | + | |
| 24 | +new const PLUGIN[] = "CSB Checkpoints" | |
| 25 | +new const VERSION[] = "1.0.0" | |
| 26 | +new const AUTHOR[] = "counter-strike-boost.com" | |
| 27 | + | |
| 28 | +#define MAX_CP 8 | |
| 29 | +#define FL_ONGROUND (1<<9) | |
| 30 | + | |
| 31 | +new g_pEnabled, g_pGroundOnly | |
| 32 | + | |
| 33 | +new Float:g_cpOrigin[33][MAX_CP][3] | |
| 34 | +new Float:g_cpAngles[33][MAX_CP][3] | |
| 35 | +new Float:g_cpVel[33][MAX_CP][3] | |
| 36 | +new g_cpCount[33] | |
| 37 | +new g_cpCycle[33] | |
| 38 | + | |
| 39 | +public plugin_init() | |
| 40 | +{ | |
| 41 | + register_plugin(PLUGIN, VERSION, AUTHOR) | |
| 42 | + | |
| 43 | + g_pEnabled = register_cvar("csb_cp_enabled", "1") | |
| 44 | + g_pGroundOnly = register_cvar("csb_cp_groundonly", "1") | |
| 45 | + | |
| 46 | + register_clcmd("say /cp", "cmdSave") | |
| 47 | + register_clcmd("say_team /cp", "cmdSave") | |
| 48 | + register_clcmd("say /tp", "cmdRestore") | |
| 49 | + register_clcmd("say_team /tp", "cmdRestore") | |
| 50 | + register_clcmd("say /gocheck", "cmdCycle") | |
| 51 | + register_clcmd("say_team /gocheck", "cmdCycle") | |
| 52 | + register_clcmd("say /clearcp", "cmdClear") | |
| 53 | +} | |
| 54 | + | |
| 55 | +public client_putinserver(id) | |
| 56 | +{ | |
| 57 | + g_cpCount[id] = 0 | |
| 58 | + g_cpCycle[id] = 0 | |
| 59 | +} | |
| 60 | + | |
| 61 | +public cmdSave(id) | |
| 62 | +{ | |
| 63 | + if (!get_pcvar_num(g_pEnabled) || !is_user_alive(id)) | |
| 64 | + return PLUGIN_HANDLED | |
| 65 | + | |
| 66 | + if (get_pcvar_num(g_pGroundOnly) && !(pev(id, pev_flags) & FL_ONGROUND)) | |
| 67 | + { | |
| 68 | + client_print(id, print_chat, "[CSB] You must be on the ground to save a checkpoint.") | |
| 69 | + return PLUGIN_HANDLED | |
| 70 | + } | |
| 71 | + | |
| 72 | + if (g_cpCount[id] >= MAX_CP) | |
| 73 | + { | |
| 74 | + /* drop the oldest by shifting down */ | |
| 75 | + for (new i = 1; i < MAX_CP; i++) | |
| 76 | + { | |
| 77 | + copyVec(g_cpOrigin[id][i - 1], g_cpOrigin[id][i]) | |
| 78 | + copyVec(g_cpAngles[id][i - 1], g_cpAngles[id][i]) | |
| 79 | + copyVec(g_cpVel[id][i - 1], g_cpVel[id][i]) | |
| 80 | + } | |
| 81 | + | |
| 82 | + g_cpCount[id] = MAX_CP - 1 | |
| 83 | + } | |
| 84 | + | |
| 85 | + new slot = g_cpCount[id] | |
| 86 | + | |
| 87 | + pev(id, pev_origin, g_cpOrigin[id][slot]) | |
| 88 | + pev(id, pev_v_angle, g_cpAngles[id][slot]) | |
| 89 | + pev(id, pev_velocity, g_cpVel[id][slot]) | |
| 90 | + | |
| 91 | + g_cpCount[id]++ | |
| 92 | + g_cpCycle[id] = g_cpCount[id] - 1 | |
| 93 | + | |
| 94 | + showCount(id, "Checkpoint saved") | |
| 95 | + return PLUGIN_HANDLED | |
| 96 | +} | |
| 97 | + | |
| 98 | +public cmdRestore(id) | |
| 99 | +{ | |
| 100 | + if (!get_pcvar_num(g_pEnabled) || !is_user_alive(id)) | |
| 101 | + return PLUGIN_HANDLED | |
| 102 | + | |
| 103 | + if (g_cpCount[id] <= 0) | |
| 104 | + { | |
| 105 | + client_print(id, print_chat, "[CSB] No checkpoint saved yet. Use /cp first.") | |
| 106 | + return PLUGIN_HANDLED | |
| 107 | + } | |
| 108 | + | |
| 109 | + teleport(id, g_cpCount[id] - 1) | |
| 110 | + showCount(id, "Teleported to last checkpoint") | |
| 111 | + return PLUGIN_HANDLED | |
| 112 | +} | |
| 113 | + | |
| 114 | +public cmdCycle(id) | |
| 115 | +{ | |
| 116 | + if (!get_pcvar_num(g_pEnabled) || !is_user_alive(id)) | |
| 117 | + return PLUGIN_HANDLED | |
| 118 | + | |
| 119 | + if (g_cpCount[id] <= 0) | |
| 120 | + { | |
| 121 | + client_print(id, print_chat, "[CSB] No checkpoints saved.") | |
| 122 | + return PLUGIN_HANDLED | |
| 123 | + } | |
| 124 | + | |
| 125 | + g_cpCycle[id] = (g_cpCycle[id] + 1) % g_cpCount[id] | |
| 126 | + teleport(id, g_cpCycle[id]) | |
| 127 | + | |
| 128 | + client_print(id, print_chat, "[CSB] Checkpoint %d / %d.", g_cpCycle[id] + 1, g_cpCount[id]) | |
| 129 | + return PLUGIN_HANDLED | |
| 130 | +} | |
| 131 | + | |
| 132 | +public cmdClear(id) | |
| 133 | +{ | |
| 134 | + g_cpCount[id] = 0 | |
| 135 | + g_cpCycle[id] = 0 | |
| 136 | + client_print(id, print_chat, "[CSB] Checkpoints cleared.") | |
| 137 | + return PLUGIN_HANDLED | |
| 138 | +} | |
| 139 | + | |
| 140 | +teleport(id, slot) | |
| 141 | +{ | |
| 142 | + if (slot < 0 || slot >= g_cpCount[id]) | |
| 143 | + return | |
| 144 | + | |
| 145 | + engfunc(EngFunc_SetOrigin, id, g_cpOrigin[id][slot]) | |
| 146 | + set_pev(id, pev_angles, g_cpAngles[id][slot]) | |
| 147 | + set_pev(id, pev_v_angle, g_cpAngles[id][slot]) | |
| 148 | + set_pev(id, pev_fixangle, 1) | |
| 149 | + set_pev(id, pev_velocity, g_cpVel[id][slot]) | |
| 150 | +} | |
| 151 | + | |
| 152 | +copyVec(Float:dest[3], const Float:src[3]) | |
| 153 | +{ | |
| 154 | + dest[0] = src[0] | |
| 155 | + dest[1] = src[1] | |
| 156 | + dest[2] = src[2] | |
| 157 | +} | |
| 158 | + | |
| 159 | +showCount(id, const what[]) | |
| 160 | +{ | |
| 161 | + client_print(id, print_chat, "[CSB] %s (%d stored).", what, g_cpCount[id]) | |
| 162 | +} |
csb.json
A
| @@ -0,0 +1,57 @@ | ||
| 1 | +{ | |
| 2 | + "name": "CSB Checkpoints", | |
| 3 | + "category": "movement", | |
| 4 | + "tags": "checkpoint, cp, tp", | |
| 5 | + "image": "", | |
| 6 | + "original_author": "KZ Checkpoints", | |
| 7 | + "original_url": "", | |
| 8 | + "license": "GPL-3.0", | |
| 9 | + "title": "CSB Checkpoints", | |
| 10 | + "short_desc": "KZ-style checkpoints: /cp saves origin, angles and velocity, /tp restores, /gocheck cycles saved points.", | |
| 11 | + "version": "1.0.0", | |
| 12 | + "amxx_min": "1.9", | |
| 13 | + "amxx_compile_default": "1.9", | |
| 14 | + "rehlds_ok": true, | |
| 15 | + "hlds_ok": true, | |
| 16 | + "regamedll_required": false, | |
| 17 | + "metamod_flavor": "any", | |
| 18 | + "reapi_required": false, | |
| 19 | + "modules": "fakemeta", | |
| 20 | + "install_notes": "1. Enable the fakemeta module in addons/amxmodx/configs/modules.ini\n2. Put csb_checkpoints.amxx in addons/amxmodx/plugins/ and add it to plugins.ini\n3. Change map", | |
| 21 | + "known_conflicts": "Intended for climb/KZ/surf servers; on competitive maps teleporting is a cheat, so gate it behind those game modes.", | |
| 22 | + "cvars": [ | |
| 23 | + { | |
| 24 | + "name": "csb_cp_enabled", | |
| 25 | + "default": "1", | |
| 26 | + "description": "Enable or disable checkpoints." | |
| 27 | + }, | |
| 28 | + { | |
| 29 | + "name": "csb_cp_groundonly", | |
| 30 | + "default": "1", | |
| 31 | + "description": "Only allow saving a checkpoint while on the ground." | |
| 32 | + } | |
| 33 | + ], | |
| 34 | + "commands": [ | |
| 35 | + { | |
| 36 | + "name": "say /cp", | |
| 37 | + "access": "", | |
| 38 | + "description": "Save a checkpoint at your current position." | |
| 39 | + }, | |
| 40 | + { | |
| 41 | + "name": "say /tp", | |
| 42 | + "access": "", | |
| 43 | + "description": "Teleport back to the last saved checkpoint." | |
| 44 | + }, | |
| 45 | + { | |
| 46 | + "name": "say /gocheck", | |
| 47 | + "access": "", | |
| 48 | + "description": "Cycle through all saved checkpoints." | |
| 49 | + }, | |
| 50 | + { | |
| 51 | + "name": "say /clearcp", | |
| 52 | + "access": "", | |
| 53 | + "description": "Clear all your saved checkpoints." | |
| 54 | + } | |
| 55 | + ], | |
| 56 | + "main": "addons/amxmodx/scripting/csb_checkpoints.sma" | |
| 57 | +} | |
| 0 | 58 |
