Skip to content

Commit

Permalink
update castles, cool_trees, plantlife, basic_materials, bees, bonemeal,
Browse files Browse the repository at this point in the history
homedecor, currency, digilines, farming redo, item_drop, maptools,
mesecons, moreblocks, moreores, moretrees, pipeworks, signs_lib,
stained_glass, technic, titanium, unified_inventory, unifieddyes,and
worldedit.

added Tenplus1's ambience mod
  • Loading branch information
VanessaE committed Nov 1, 2020
1 parent 2c901a7 commit e124b79
Show file tree
Hide file tree
Showing 743 changed files with 19,368 additions and 18,527 deletions.
22 changes: 22 additions & 0 deletions ambience/README.md
@@ -0,0 +1,22 @@
Ambience Redo mod for Minetest
by TenPlus1

Based on Immersive Sounds .36 mod by Neuromancer and optimized to run on servers with new fire sounds added when Fire Redo mod is detected...

- 0.1 - Initial release
- 0.2 - Code change and new water sounds added
- 0.3 - Works with Fire Redo mod to provide fire sounds
- 0.4 - Code optimized
- 0.5 - Changed to kilbiths smaller sound files and removed canadianloon1, adjusted timings
- 0.6 - Using new find_nodes_in_area features to count nodes and speed up execution (thanks everamzah)
- 0.7 - Code tweaks and added Jungle sounds for day and night time
- 0.8 - Override default water sounds for 0.4.14 dev and above, add separate gain for each sound
- 0.9 - Plays music files on server or local client when found at midnight, files to be named "ambience_music.1.ogg" changing number each up to 9.
- 1.0 - Added icecrack sound when walking on snow/ice flows, also tidied code
- 1.1 - Using newer functions, Minetest 0.4.16 and above needed to run
- 1.2 - Added PlayerPlus compatibility, removed fire sounds, added volume changes
- 1.3 - Added API for use with other mods, code rewrite
- 1.4 - Re-ordered water sets to come before fire and lava, day/night sounds play when leaves around and above ground
- 1.5 - Added 'flame_sound' and fire redo check, code tidy and tweak, added ephemeral flag for background sounds.

Code license: MIT
91 changes: 91 additions & 0 deletions ambience/api.txt
@@ -0,0 +1,91 @@

Ambience Lite API
=================

This short guide will show you how to add sound sets into ambience mod for the
api to use and play sounds accordingly. Please note that the order they are
added will affect sound checks, so high priority sets first.


Function Usage
==============


Adding Sound Set
----------------

ambience.add_set(set_name, def)
'set_name' contains the name of the sound set to add
'def' contains the following:
'frequency' how often the sound set is played (1 to 1000) higher is more
'nodes' contains a table of nodes needed for checks
'sound_check(def)' function to check if sounds can be played, def contains:
'player' player userdata
'pos' position of player
'tod' time of day
'totals' totals for each node e.g. def.totals["default:sand"]
'positions' position data for every node found
'head_node' name of node at player head level
'feet_node' nameof node at player foot level

This will let you add a set or sounds with the frequency it's used and check
function for it to play. If ephemeral is true then no handler will be used and sound will be played in background alongside other sounds.

e.g.

ambience.add_set("windy", {
frequency = 500,
nodes = {"default:sand"},
sounds = {
{name = "wind", length = 9, gain = 0.3},
{name = "desertwind", length = 8, gain = 0.3},
{name = "crow", length = 3, ephemeral = true},
},
sound_check = function(def)
local number = totals["default:sand"] or 0 -- yep, can also be nil
if number > 20 then
return "windy", 0.2 -- return set to play and optional gain volume
end
end,
})


Getting Sound Set
-----------------

ambience.get_set(set_name)

This returns a table containing all of the set information like example above.

e.g.

local myset = ambience.get_set("windy") -- returns everything inside {} above.


Deleting Sound Set
------------------

ambience.del_set(set_name)

This will remove a sound set from the list.

e.g.

ambience.del_set("windy")


Additional Commands
===================

Two volume commands have been added to set sound and music volume:

/svol (0.1 to 1.0)
/mvol (0.1 to 1.0) -- 0 can be used to stop music from playing when it begins


Music
=====

Music can be stored in the sounds folder either on server or locally and so long
as it is named 'ambience_music.1', 'ambience_music.2' etc. then it will select
a song randomly at midnight and play player.
3 changes: 3 additions & 0 deletions ambience/depends.txt
@@ -0,0 +1,3 @@
default
fire?
playerplus?
1 change: 1 addition & 0 deletions ambience/description.txt
@@ -0,0 +1 @@
Adds realistic sound effects into your world.

0 comments on commit e124b79

Please sign in to comment.