Wuzzy/libpov_2025
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Rename to "LiBPoV"

Browse Source
This commit is contained in:
Wuzzy 2024-10-14 00:32:07 +02:00
parent 67a00abd34
commit ec260d66d9
7 changed files with 29 additions and 29 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
LICENSE.md
View File

@ -1,6 +1,6 @@
# License # License
MiBPoV (Minetest Biome Point Visualizer) is Copyright by (c) Wuzzy, 2023 and is released under the MIT License. LiBPoV (Luanti Biome Point Visualizer) is Copyright by (c) Wuzzy, 2023 and is released under the MIT License.
Javascript-Voronoi is Copyright (c) by Raymond Hill, 2010-2013 and is released under the MIT License. Javascript-Voronoi is Copyright (c) by Raymond Hill, 2010-2013 and is released under the MIT License.
## The MIT License ## The MIT License

6
README.md
View File

@ -1,8 +1,8 @@
# MiBPoV—Minetest Biome Point Visualizer # LiBPoV—Luanti Biome Point Visualizer
MiBPov is a tool for people who develop games and mods for a [Minetest](https://minetest.net). It allows them to visualize the heat and humidity points of biomes, making it easier to edit them. It is a webpage using JavaScript. A manual is included. LiBPoV is a tool for people who develop games and mods for a [Luanti](https://minetest.net). It allows them to visualize the heat and humidity points of biomes, making it easier to edit them. It is a webpage using JavaScript. A manual is included.
[Use MiBPoV in your browser now!](https://wuzzy.codeberg.page/MiBPoV/) [Use LiBPoV in your browser now!](https://wuzzy.codeberg.page/LiBPoV/)
If you want to use it locally instead, simply open `index.html` in your browser. If you want to use it locally instead, simply open `index.html` in your browser.

2
dark_style.css
View File

@ -1,5 +1,5 @@
/* /*
Style sheet for the Minetest Biome Point Visualizer. Style sheet for the Luanti Biome Point Visualizer.
License: MIT License License: MIT License
*/ */

8
index.html
View File

@ -4,14 +4,14 @@
<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<link rel="icon" href="./favicon.png"> <link rel="icon" href="./favicon.png">
<link rel="stylesheet" href="./dark_style.css"> <link rel="stylesheet" href="./dark_style.css">
<title>MiBPoV—Minetest Biome Point Visualizer</title> <title>LiBPoV—Luanti Biome Point Visualizer</title>
<!-- Include Voronoi diagram API, required to calculate Voronoi diagrams --> <!-- Include Voronoi diagram API, required to calculate Voronoi diagrams -->
<script src="./rhill-voronoi-core.js"></script> <script src="./rhill-voronoi-core.js"></script>
</head> </head>
<body> <body>
<h1>MiBPoV—Minetest Biome Point Visualizer</h1> <h1>LiBPoV—Luanti Biome Point Visualizer</h1>
<div class="contentContainer" id="noscriptContainer"> <div class="contentContainer" id="noscriptContainer">
<noscript> <noscript>
<div class="borderedWarning"> <div class="borderedWarning">
@ -208,12 +208,12 @@ A Voronoi diagram is supposed to be here but for some reason it cannot be displa
<hr> <hr>
<div class="contentContainer"> <div class="contentContainer">
<!-- footer --> <!-- footer -->
<p><a title="MiBPoV manual" href="./manual.html">Manual</a> | <a title="MiBPoV source code" href="https://codeberg.org/Wuzzy/MiBPoV">Source code</a> | <a title="MiBPoV bug tracker" href="https://codeberg.org/Wuzzy/MiBPoV/issues">Bug tracker</a> | <a title="License" data-jslicense="1" href="./license.html">License</a></p> <p><a title="LiBPoV manual" href="./manual.html">Manual</a> | <a title="LiBPoV source code" href="https://codeberg.org/Wuzzy/LiBPoV">Source code</a> | <a title="LiBPoV bug tracker" href="https://codeberg.org/Wuzzy/LiBPoV/issues">Bug tracker</a> | <a title="License" data-jslicense="1" href="./license.html">License</a></p>
<p>This is free software released under the <a title="License" href="./license.html">MIT License</a>. Code by <a title="Wuzzy’s Personal Website" href="https://wuzzy.codeberg.page/">Wuzzy</a>. Uses <a title="Javascript-Voronoi Git repository webpage" href="https://github.com/gorhill/Javascript-Voronoi/">Javascript-Voronoi</a> by <a title="Raymond Hill’s personal website" href="http://www.raymondhill.net/">Raymond Hill</a>.</p> <p>This is free software released under the <a title="License" href="./license.html">MIT License</a>. Code by <a title="Wuzzy’s Personal Website" href="https://wuzzy.codeberg.page/">Wuzzy</a>. Uses <a title="Javascript-Voronoi Git repository webpage" href="https://github.com/gorhill/Javascript-Voronoi/">Javascript-Voronoi</a> by <a title="Raymond Hill’s personal website" href="http://www.raymondhill.net/">Raymond Hill</a>.</p>
</div> </div>
<!-- The main script handling all the UI stuff --> <!-- The main script handling all the UI stuff -->
<script src="./mibpov.js"></script> <script src="./libpov.js"></script>
</body> </body>
</html> </html>

2
mibpov.js → libpov.js
View File

@ -2260,7 +2260,7 @@ function hexColorToRGBColor(hexColor) {
inputExportAmidstForMinetest.onclick = function() { inputExportAmidstForMinetest.onclick = function() {
let jsonOut = {}; let jsonOut = {};
jsonOut.name = "MiBPoV Export"; jsonOut.name = "LiBPoV Export";
let jsonPoints = []; let jsonPoints = [];
for (let b=0; b<biomePoints.length; b++) { for (let b=0; b<biomePoints.length; b++) {
let biome = biomePoints[b]; let biome = biomePoints[b];

10
license.html
View File

@ -3,15 +3,15 @@
<head> <head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<link rel="icon" href="./favicon.png"> <link rel="icon" href="./favicon.png">
<title>License of MiBPoV</title> <title>License of LiBPoV</title>
<link rel="stylesheet" href="./dark_style.css"> <link rel="stylesheet" href="./dark_style.css">
</head> </head>
<body> <body>
<h1>License of MiBPov</h1> <h1>License of LiBPov</h1>
<div id="mainContentContainer" class="contentContainer"> <div id="mainContentContainer" class="contentContainer">
<p><a href="./index.html">Back to the main program</a></p> <p><a href="./index.html">Back to the main program</a></p>
<p>MiBPov (Minetest Biome Point Visualizer) was created by Wuzzy in 2023. It uses <a href="https://github.com/gorhill/Javascript-Voronoi">Javascript-Voronoi</a> by Raymon Hill, Copyright (c) 2010-2013.</p> <p>LiBPov (Luanti Biome Point Visualizer) was created by Wuzzy in 2023. It uses <a href="https://github.com/gorhill/Javascript-Voronoi">Javascript-Voronoi</a> by Raymon Hill, Copyright (c) 2010-2013.</p>
<p>Both programs (which includes associated files, like the manual, stylesheet, favicon etc.) are free software, released under the MIT License (also known as “Expat”), written below.</p> <p>Both programs (which includes associated files, like the manual, stylesheet, favicon etc.) are free software, released under the MIT License (also known as “Expat”), written below.</p>
@ -34,9 +34,9 @@
</tr> </tr>
<tr> <tr>
<td><a href="./mibpov.js">mibpov.js</a></td> <td><a href="./libpov.js">libpov.js</a></td>
<td><a href="http://www.jclark.com/xml/copying.txt">Expat</a></td> <td><a href="http://www.jclark.com/xml/copying.txt">Expat</a></td>
<td><a href="./mibpov.js">mibpov.js</a></td> <td><a href="./libpov.js">libpov.js</a></td>
</tr> </tr>
</tbody> </tbody>
</table> </table>

28
manual.html
View File

@ -3,16 +3,16 @@
<head> <head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<link rel="icon" href="./favicon.png"> <link rel="icon" href="./favicon.png">
<title>Manual for the Minetest Biome Point Visualizer</title> <title>Manual for the Luanti Biome Point Visualizer</title>
<link rel="stylesheet" href="./dark_style.css"> <link rel="stylesheet" href="./dark_style.css">
</head> </head>
<body> <body>
<h1>MiBPoV Manual</h1> <h1>LiBPoV Manual</h1>
<div id="mainContentContainer" class="contentContainer"> <div id="mainContentContainer" class="contentContainer">
<p><a href="./index.html">Back to the main program</a></p> <p><a href="./index.html">Back to the main program</a></p>
<h2>What is this?</h2> <h2>What is this?</h2>
<p>MiBPov is the <u>Mi</u>netest <u>B</u>iome <u>Po</u>int <u>V</u>isualizer, a tool for people who develop games and mods for <a href="https://minetest.net">Minetest</a>. It allows them to <b>visualize the heat and humidity points</b> of biomes. It runs in your <b>web browser</b> using JavaScript.</p> <p>LiBPoV is the <u>L</u>uant<u>i</u> <u>B</u>iome <u>Po</u>int <u>V</u>isualizer, a tool for people who develop games and mods for <a href="https://minetest.net">Luanti</a>. It allows them to <b>visualize the heat and humidity points</b> of biomes. It runs in your <b>web browser</b> using JavaScript.</p>
<h2>Features</h2> <h2>Features</h2>
<ul> <ul>
@ -24,15 +24,15 @@
</ul> </ul>
<h2>Quick reminder how biomes work</h2> <h2>Quick reminder how biomes work</h2>
<p>When Minetest generates the world, each (X, Z) coordinate is assigned a <b>heat</b> and <b>humidity</b> value (“heat” is also sometimes called “temperature”). Also, each biome is assigned a heat and humidity value as well. Heat and humidity act as coordinates on a <b>2-dimensional plane</b>. For any world position, the biome that has a heat and humidity value that are closest to the heat and humidity will be used for that position. This happens for every position.</p> <p>When Luanti generates the world, each (X, Z) coordinate is assigned a <b>heat</b> and <b>humidity</b> value (“heat” is also sometimes called “temperature”). Also, each biome is assigned a heat and humidity value as well. Heat and humidity act as coordinates on a <b>2-dimensional plane</b>. For any world position, the biome that has a heat and humidity value that are closest to the heat and humidity will be used for that position. This happens for every position.</p>
<p>Minetest also may apply “blending” at the biome borders for a smoother transition, but this is ignored in MiBPoV.</p> <p>Luanti also may apply “blending” at the biome borders for a smoother transition, but this is ignored in LiBPoV.</p>
<p>The challenge for the developer is to figure out good heat and humidity points of custom biomes to make sure they are well-balanced. This is where this program will help you.</p> <p>The challenge for the developer is to figure out good heat and humidity points of custom biomes to make sure they are well-balanced. This is where this program will help you.</p>
<p>The v6 map generator is an exception: Here, biomes don’t have heat and humidity points. Instead, Minetest instead just checks if the world position’s heat and humidity lies between some (mostly) hardcoded values and then decides which of the hardcoded biomes to use.</p> <p>The v6 map generator is an exception: Here, biomes don’t have heat and humidity points. Instead, Luanti instead just checks if the world position’s heat and humidity lies between some (mostly) hardcoded values and then decides which of the hardcoded biomes to use.</p>
<p>Please refer to the official Minetest Lua API documentation for a more in-depth explanation.</p> <p>Please refer to the official Luanti Lua API documentation for a more in-depth explanation.</p>
<h2>Interpreting the diagram</h2> <h2>Interpreting the diagram</h2>
<p>On top of the page, you see the biome diagram. The horizontal axis represents heat and the vertical axis represents humidity. The visible diagram area represents all mathematically possible values. Note that the further you go from the center, the less likely they will become, with the area close to the border being extremely unlikely.</p> <p>On top of the page, you see the biome diagram. The horizontal axis represents heat and the vertical axis represents humidity. The visible diagram area represents all mathematically possible values. Note that the further you go from the center, the less likely they will become, with the area close to the border being extremely unlikely.</p>
@ -60,7 +60,7 @@
<h3>Biome modes</h3> <h3>Biome modes</h3>
<p>Above the diagram, there are two buttons: “Biome points” and “v6 biomes”. These are the <b>biome modes</b>. Click on one of these buttons to change the biome mode. This affects the entire program.</p> <p>Above the diagram, there are two buttons: “Biome points” and “v6 biomes”. These are the <b>biome modes</b>. Click on one of these buttons to change the biome mode. This affects the entire program.</p>
<p>In “<b>biome points</b>” mode, you can add, see and visualize heat and humidity points as well as the biome area on a diagram. This is the default mode. Biome points are used in all Minetest map generators except v6.</p> <p>In “<b>biome points</b>” mode, you can add, see and visualize heat and humidity points as well as the biome area on a diagram. This is the default mode. Biome points are used in all Luanti map generators except v6.</p>
<p>The “<b>v6 biomes</b>” mode displays the biomes of the v6 mapgen. The v6 biomes work completely differently and are hardcoded because this mapgen is very old. There are no biome points and your options to configure them are limited to a few settings only. You can’t add custom biomes here.</p> <p>The “<b>v6 biomes</b>” mode displays the biomes of the v6 mapgen. The v6 biomes work completely differently and are hardcoded because this mapgen is very old. There are no biome points and your options to configure them are limited to a few settings only. You can’t add custom biomes here.</p>
@ -86,7 +86,7 @@
<p>Changing a value in any of these fields will immediately take effect.</p> <p>Changing a value in any of these fields will immediately take effect.</p>
<h4>“v6 biomes” mode</h4> <h4>“v6 biomes” mode</h4>
<p>In this mode you can configure a few settings of the v6 biomes. The “Flags” sections changes the v6-specific mapgen flags (on/off settings) and corresponds to the Minetest setting <code>mgv6_spflags</code>. The Desert noise threshold corresponds to <code>mgv6_freq_desert</code>.</p> <p>In this mode you can configure a few settings of the v6 biomes. The “Flags” sections changes the v6-specific mapgen flags (on/off settings) and corresponds to the Luanti setting <code>mgv6_spflags</code>. The Desert noise threshold corresponds to <code>mgv6_freq_desert</code>.</p>
<p>These settings can be changed:</p> <p>These settings can be changed:</p>
@ -106,7 +106,7 @@
<p>Note: If you hide the points, you can no longer select them in the diagram. You can still select them in the biome list, however.</p> <p>Note: If you hide the points, you can no longer select them in the diagram. You can still select them in the biome list, however.</p>
<h3>Noise parameters</h3> <h3>Noise parameters</h3>
<p>This is fairly advanced and most games don’t modify this. You can experiment with this if you want to see what happens if you use non-default heat and/or humidity Perlin noise parameters. The parenthesis if the Heat and Humidity sections show the name of the setting the noise parameters correspond to. The noise setting names depend on the current biome mode. The explanation of Perlin noises is out of scope for this document. See the Minetest Lua API documentation.</p> <p>This is fairly advanced and most games don’t modify this. You can experiment with this if you want to see what happens if you use non-default heat and/or humidity Perlin noise parameters. The parenthesis if the Heat and Humidity sections show the name of the setting the noise parameters correspond to. The noise setting names depend on the current biome mode. The explanation of Perlin noises is out of scope for this document. See the Luanti Lua API documentation.</p>
<p>Changing the noise parameters has an <b>effect on the possible value range</b> for heat and humidity which has an effect on the probability of all biomes.</p> <p>Changing the noise parameters has an <b>effect on the possible value range</b> for heat and humidity which has an effect on the probability of all biomes.</p>
@ -126,7 +126,7 @@
<p>The <b>Lua</b> export gives you a very basic Lua code that can be pasted into an actual Lua mod. The code is very basic and does not include the “landscape materials”, like what the surface is made of (dirt, stone, sand, etc.).</p> <p>The <b>Lua</b> export gives you a very basic Lua code that can be pasted into an actual Lua mod. The code is very basic and does not include the “landscape materials”, like what the surface is made of (dirt, stone, sand, etc.).</p>
<p>The <b>JSON</b> export is a text you can use to import the biomes in MiBPoV later. You may want to copy this into a text file.</p> <p>The <b>JSON</b> export is a text you can use to import the biomes in LiBPoV later. You may want to copy this into a text file.</p>
<p>The <b>Amidst for Minetest</b> export gives you a biome profile you can use for <a href="https://github.com/Treer/Amidst-for-Minetest">Amidst for Minetest</a>.</p> <p>The <b>Amidst for Minetest</b> export gives you a biome profile you can use for <a href="https://github.com/Treer/Amidst-for-Minetest">Amidst for Minetest</a>.</p>
@ -135,12 +135,12 @@
<h2>Caveats / Limitations</h2> <h2>Caveats / Limitations</h2>
<p>In “biome points” mode, it is perfectly <b>legal</b> to have the biome points to be <b>out of the bounds</b> of the diagram. These out-of-bounds points are represented as arrows in the diagram. However, you can’t select them with your mouse on the diagram unless it’s close to the edge. Use the biome list to edit points that are out of bounds.</p> <p>In “biome points” mode, it is perfectly <b>legal</b> to have the biome points to be <b>out of the bounds</b> of the diagram. These out-of-bounds points are represented as arrows in the diagram. However, you can’t select them with your mouse on the diagram unless it’s close to the edge. Use the biome list to edit points that are out of bounds.</p>
<p>Heat/humidity <b>values above 1,000,000 or below &minus;1,000,000</b> are <b>not supported</b> and will trigger an error message. This is a much smaller range than what Minetest supports. Also, no diagram can be drawn if the heat or humidity noise scale equals 0 or is very small, although this is legal in Minetest. This does not mean that your chosen settings won’t work in Minetest, just that MiBPoV can’t visualize them.</p> <p>Heat/humidity <b>values above 1,000,000 or below &minus;1,000,000</b> are <b>not supported</b> and will trigger an error message. This is a much smaller range than what Luanti supports. Also, no diagram can be drawn if the heat or humidity noise scale equals 0 or is very small, although this is legal in Luanti. This does not mean that your chosen settings won’t work in Luanti, just that LiBPoV can’t visualize them.</p>
<p>MiBPoV assumes that the <code>absvalue</code> flag of the heat/humidity noises is always <code>false</code>. So if your game/mod has sets it to true, the diagram may still show a value range that is actually impossible.</p> <p>LiBPoV assumes that the <code>absvalue</code> flag of the heat/humidity noises is always <code>false</code>. So if your game/mod has sets it to true, the diagram may still show a value range that is actually impossible.</p>
<h2>Credits / License</h2> <h2>Credits / License</h2>
<p>MiBPoV is <b>free software</b>. See the <a href="./license.html">License</a> page for details.</p> <p>LiBPoV is <b>free software</b>. See the <a href="./license.html">License</a> page for details.</p>
</div> </div>
</body> </body>