UsefulHints
An Exiled & LabAPI (SCP:SL) Plugin that display extra hint like a timers and notifications
Install / Use
/learn @Vretu-Dev/UsefulHintsREADME
Downloads:
| Framework | Version | Release | |:---------:|:----------:|:----------------------------------------------------------------------:| | Exiled | ≥ 9.12.2 | ⬇️ | | LabAPI | ≥ 1.1.4 | ⬇️ |
<h2>Features:</h2>- SCP-268, SCP-2176 and SCP-1576 timer
- Hint displayed when looking at SCP-096's face
- Track remaining Jailbird charges
- Display SCP-207 & Anti SCP-207 doses when picked up
- Warning hints when affected by SCP-207, Anti SCP-207, or SCP-1853
- Friendly fire warnings when damaging teammates
- Kill counter for players
- End-of-game summary
- Show teammates at the start of the round
- Broadcast the last human alive
is_enabled: true
debug: false
# Specific Server Settings:
enable_server_settings: true
# Hint Settings:
enable_hints: true
scp096_look_message: 'You looked at SCP-096!'
scp268_time_left_message: 'Remaining: {0}s'
scp2176_time_left_message: 'Remaining: {0}s'
scp1576_time_left_message: 'Remaining: {0}s'
grenade_damage_hint: '{0} Damage'
jailbird_use_message: 'Remaining charges: {0}'
scp207_hint_message: 'You have {0} doses of SCP-207'
anti_scp207_hint_message: 'You have {0} doses of Anti SCP-207'
show_hint_on_equip_item: false
# Item Warnings:
enable_warnings: true
scp207_warning: '<color=yellow>⚠</color> You are already affected by <color=#A60C0E>SCP-207</color>'
anti_scp207_warning: '<color=yellow>⚠</color> You are already affected by <color=#2969AD>Anti SCP-207</color>'
scp1853_warning: '<color=yellow>⚠</color> You are already affected by <color=#1CAA21>SCP-1853</color>'
# Friendly Fire Warning:
enable_ff_warning: true
friendly_fire_warning: '<size=27><color=yellow>⚠ Do not hurt your teammate</color></size>'
damage_taken_warning: '<size=27><color=red>{0}</color> <color=yellow>(teammate) hit you</color></size>'
class_d_are_teammates: true
enable_cuffed_warning: false
cuffed_attacker_warning: '<size=27><color=yellow>⚠ Player is cuffed</color></size>'
cuffed_player_warning: '<size=27><color=red>{0}</color> <color=yellow>hit you when you were cuffed</color></size>'
# Kill Counter:
enable_kill_counter: true
kill_count_message: '{0} kills'
count_pocket_kills: false
# Round Summary:
enable_round_summary: true
round_summary_message_duration: 10
human_kill_message: '<size=27><color=#70EE9C>{0}</color> had the most kills as a <color=green>Human</color>: <color=yellow>{1}</color></size>'
scp_kill_message: '<size=27><color=#70EE9C>{0}</color> had the most kills as a <color=red>SCP</color>: <color=yellow>{1}</color></size>'
top_damage_message: '<size=27><color=#70EE9C>{0}</color> dealt the most damage: <color=yellow>{1}</color></size>'
first_scp_killer_message: '<size=27><color=#70EE9C>{0}</color> was the first to kill an <color=red>SCP</color></size>'
escaper_message: '<size=27><color=#70EE9C>{0}</color> escaped first from the facility: <color=yellow>{1}:{2}</color></size>'
# Teammates:
enable_teammates: true
teammate_hint_delay: 4
teammate_hint_message: |-
<align=left><size=28><color=#70EE9C>Your Teammates</color></size>
<size=25><color=yellow>{0}</color></size></align>
teammate_message_duration: 8
alone_hint_message: '<align=left><color=red>You are playing Solo</color></align>'
alone_message_duration: 4
# Last Human Broadcast:
enable_last_human_broadcast: true
broadcast_for_human: '<color=red>You are the last human alive!</color>'
broadcast_for_scp: '<color=#70EE9C>{0}</color> is the last human alive, playing as {1} in <color=yellow>{2}</color>'
ignore_tutorial_role: true
# Map Broadcast:
enable_map_broadcast: true
broadcast_warning_lcz: '<color=yellow>Light Zone</color> will be decontaminated in 5 minutes!'
</details>
<h2>Showcase:</h2>
<details>
<summary><b>(click to expand) 🖼️</b></summary>
Hints:
https://github.com/user-attachments/assets/f2125ab2-4ee3-4c71-a697-88949c00ddc2
Summary:
<p align="center"> <img src="https://github.com/user-attachments/assets/38238ca6-30f8-432d-a50d-71cacea1212b"> </p>Teammates:
<p align="center"> <img src="https://github.com/user-attachments/assets/9cd2ecce-237d-4801-bbe5-c253e8e22121"> </p>Last Alive Human:
<p align="center"> <img src="https://github.com/user-attachments/assets/c1a547af-c01a-4060-b810-0aeece2a9f7f"> <img src="https://github.com/user-attachments/assets/14829059-9249-4f53-a54b-2f5820a6f208"> </p> </details> <h2>Addons:</h2><details> <summary><b>Auto-Translations 🌎</b></summary><br>[!IMPORTANT] This features required UsefulHints.Addons.dll
This extension will automatically download the available translation for the plugin from GitHub, so you don't have to translate everything yourself.
Languages
| Language | Short Name | Required Verification| |-----------|------------|---------------------- | | English | en | No | | Polish | pl | No | | Russian | ru | No | | Czech | cs | No | | Slovak | sk | Yes | | French | fr | Yes | | Spanish | es | Yes | | Italian | it | Yes | | German | de | Yes | | Turkish | tr | Yes | | Portuguese| pt | Yes | | Chinese | zh | No | | Korean | ko | No |
Command
| Command | Permission | Description | |:-----------:|:--------------------:|:----------------------------------:| | uhl <lang> | uh.changelanguage | Change language (e.g. uhl pl) | | uhl reload | uh.changelanguage | Force re-download current language | | uhl list | uh.changelanguage | Show supported languages |
Config
# Download & apply remote translations.
enable_translations: true
# pl, en, de, fr, cs, sk, es, it, pt, ru, tr, zh, ko
language: 'en'
</details> <details> <summary><b>Auto-Update 🔄</b></summary><br>
This extension will automatically download the latest release from GitHub and, depending on the configuration, restart the server.
Config
# Check GitHub releases on WaitingForPlayers.
enable_auto_update: true
# Only notify about new version.
notify_only: false
# Create .backup before overwrite.
enable_backup: false
# Show logs from addons.
enable_logging: true
# After downloading a new version restart server after round.
restart_next_round: true
</details>
<details>
<summary><b>RueI v3 Integration 🔗</b></summary><br>
This extension will replace UsefulHints ShowHint-based displays with RueI-based displays.
Config
# Enable RueI integration and replace UsefulHints ShowHint-based displays with RueI-based displays.
enable_rue_i_integration: false
</details>
Credits:
Thanks @NamelessSCP for using the RoundMVP idea.<br> Thanks @XoMiya-WPC for using the WhoAreMyTeammates idea.<br><br> Thank you to these wonderful people for testing, bug reporting and translating:
- Testers: Cat Potato, Aserciak, AVE_SATAN, N, Folia, MVP_Faker, Aime, Clown, OneManArmy<br>
- Bug Reporters: iksemdem, 𝒯𝓇𝒾𝓈𝓉𝒶𝓃𝐿𝒾𝓀𝑒𝓈𝒰𝓇𝒶𝓃 <br>
- Translators: dxstruction [RU], Vretu [PL], Vretu [EN], kldhsh123 [ZH], baek_sol_ha [KO], Lukaol-is [CS]
