luanti-org/luanti

Settings and player parameters to control damage flash and tilt

Open

#15,805 opened on Feb 18, 2025

View on GitHub
 (4 comments) (0 reactions) (0 assignees)C++ (2,395 forks)auto 404
@ Client / Audiovisuals@ Script APIConcept approvedFeature requestSSCSMgood first issue

Repository metrics

Stars
 (13,341 stars)
PR merge metrics
 (PR metrics pending)

Description

Problem

The engine has a hardcoded red flash and slight camera tilt whenever the player takes damage. Not all games need this, so it should be possible to disable it, and some might want to change the color of the flash, the tilt angle, etc. Also, some players might find the flash or tilt disorienting and so the client should be able to override or disable them from the settings for accessibility purposes.

Solutions

player:set_damage_effects() method along with a getter, using a table like so:

{
    enable_flash = true,
    flash_color = "#RRGGBBAA",
    enable_tilt = true,
    tilt_angle = ... -- not sure the best representation, probably a vector for rotation around each axis with the values being a multiplier for the calculated tilt strength
}

And equivalent settings, such as hurt_flash_enabled, hurt_flash_color (just the RGB components?), hurt_flash_strength?, hurt_tilt_enabled, hurt_tilt_strength...

Alternatives

Just the player parameters, or just the settings

Contributor guide

Research direction
Implement the set damage effects() method and corresponding settings as described in the issue. Look into the existing damage handling code to add the flash and tilt customization options.
Tech stack
lua
Domain
game dev
Issue type
Feature
DifficultyEstimated implementation difficulty for a new contributor, from 1 for very small changes to 5 for expert-level work.
3
Estimated timeA rough time range for an experienced contributor to investigate, implement, test, and prepare a pull request.
1-2 days
Activity statusHow available the issue appears right now: fresh, active, stale, blocked, or waiting on maintainer input.
Fresh
ClarityHow clearly the issue explains the expected change, acceptance criteria, and next step.
Clear
Prerequisites
C++Lua
Newbie friendlinessA 1-100 score estimating how approachable this issue is for first-time contributors.
55