Upstream
/
dynmap
mirror of https://github.com/webbukkit/dynmap.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity
Page: Defining custom lightings
Pages
. AWS S3 Storage Addons Advanced Map Configuration Base Plugin Settings Boosting areas on Dynmap BoxRenderer Class Chunk Status Colors Chunk Version Colors Color Schemes Commands Common Features for Texture and Model Definition Files Component Configuration Configuration.txt Configuring Maps and Worlds using dmap Credits Custom Block Definitions Defining a Block using a Custom Block Renderer Defining a Block using a Volumetric Model Defining a Cuboid Block Defining a Simple Block Defining cuboid models Defining custom lightings Defining custom perspectives Defining custom shaders Defining volumetric models Dmarker Dynmap API Dynmap On Xenon Hosting Service, courtesy of mavbear Dynmap With IIS Using URL Rewrite and applicationrequestrouting thanks to kekec852 Dynmap with Apache httpd on Arch Linux Dynmap with IIS Dynmap with Nginx server on Centos Dynmap with Nginx Dynmap with apache2 on Debian Dynmap with lighttpd on Arch Linux Earthmc maps Example configurations and demo website Exporting World Data in Wavefront OBJ Format External Webserver Basics External Webserver on Linux External Webserver on Windows External Webserver on hosting providers FAQ Features FenceWallBlockRenderer Class File System Storage Forwarding Dynmap port through cloudflare Full list of predefined perspectives HD Map Configuration Home How to compile Dynmap Incompatible mods Installation Setup of Dynmap on Linux Installation Internal Webserver with Caddy as a Reverse Proxy (Linux) Internal Webserver Lighttpd and SQLite on a Raspberry Pi 4 with DietPi Model Definition Files MySQL MariaDB Storage Nginx as a Reverse Proxy OCI; Oracle Cloud Instance; Quick how to enable DynMap PaneRenderer Class Permissions PostgreSQL Storage RedstoneWireRenderer Class Resources SQLite Storage Setting up Dynamic Map with apache2 under Debian Setting up Dynmap through hosting services Setting up the Dynamic Map plugin under Windows Setting up without the Internal Web Server SkullRenderer Class Special texture file types StairBlockRenderer Class Storage Setup Support for Minecraft Servers other than CraftBukkit Support for MinecraftForge based mods Support for Tekkit Texture Definition Files Textures of Dynmap Use dynmap via Pterodactyl Using Markers Using custom block renderers Web Setup Web UI Parameters Web ui login support and permissions World and template settings [Tutorial] Setting up a standalone web server with MySQL SQLite limiting render area
3 Defining custom lightings
mikeprimm edited this page 2012-02-09 23:13:37 -08:00

Custom lighting definitions can be made by modifying the standard lighting definitions, found in lightings.txt, or by adding new or updated definitions to the custom-lightings.txt file (the preferred method).

There are currently two type of lighting classes - the DefaultHDLighting class and the ShadowHDLighting class.

The DefaultHDLighting class does not modify the color data from the shader - yielding the equivalent of full daylight with no shadows - and has no configurable settings.

The ShadowHDLighting class supports several configuration settings, allowing control of ambient light levels, shadow strength, and the option of generating both night and day versions of tiles for a single map.

A typical lighting configuration is shown below:

lightings:
  - class: org.dynmap.hdmap.ShadowHDLighting
    name: my-custom-lighting
    shadowstrength: 1.0
    ambientlight: 4
    night-and-day: true
    smooth-lighting: false

The settings defined for the ShadowHDLighting class include the following:

  • name : unique name of the lighting. If a custom lighting in the custom-lightings.txt file matches a standard lighting definition's name, the standard lighting definition is replaced by the custom definition.

  • shadowstrength : this controls how strongly shadow data is applied when determining the brightness of shadowed areas. The default is 0.0 (shadow data is ignored), while normal shadows correspond to 1.0. Values above 1.0 will result in artificially severe shadows, while less that 1.0 will result in softening of shadows.

  • ambientlight : this controls the relative amount of light coming from the sky. Full daylight corresponds to 15 (the default), while normal moon-lit night is 4.

  • night-and-day : Enabling this setting (by setting the value to true) results in the generation of both night and day versions of each tile, and in the map view automatically switching between them, based on the time-of-day of the corresponding world. The difference between the 'night' tiles and the 'day' tiles is that the day tiles are rendered with ambientlight set to 15, while the night tiles use the provided ambientlight setting. The default value is false.

  • smooth-lighting : this setting, a boolean, controls the enabling of the smooth lighting option. Enabling this feature will add approximately 10% to rendering processing cost, but will result in much smoother shadows and lighting. If not defined, the smooth-lighting setting from configuration.txt is used.

Contents

Setup

Advanced Configuration

Mod Support

Developers