Inactive [FUN] AmbientSpout WIP v1.0.2 - Custom ambient music & Looping sound effects[SPOUT] [1.2.5-R4.0]

Fully rewritten

AmbientSpout

Download: http://bit.ly/MK1siY

How to setup

------------
Step 1 - Configuration:
- Start your server with the plugin installed. The plugin will generate the necessary files for you.
- Shut down your server and change config.yml to your likings.

------------
Step 2 - Adding music:
There are two ways of adding music (or sounds). Either, you make use of the built-in webserver, or you provide links to where the music can be found.
You can use both methods simoultaneously.


<< Built-in Webserver >>

With this method, you place your sounds in a specific folder (probably AmbientSpout/Resources/Ambient or AmbientSpout/Resources/EffectLoop).

For .wav files: Simply drag and drop them in.
For .ogg files: Make the last 3 characters of the filename the length of the song in seconds. Say the song (or sound) is 1 min 32 long, 1*60sec + 32 = 92.
You name your file music092.ogg (or whichever other name you like).

Note that using the webserver will use bandwidth of your server.



<< Providing Links >>

In AmbientSpout/Resources you can find Ambient.txt. In this file, you can add links to sound files. Add them in this format, one per line:
<SONGLENGTH> <LINK>

Example:
123 http://google.com/song.ogg

NOTE: The link has to be a non-secure HTTP link, so not https://. I am saying this because DropBox gives https:// links nowadays, just remove the s at the end .

Providing links is suggested (instead of webserver) if you fear the upload speed of your server is not the best, or you pay per bandwidth use.

------------
Step 3 - OPTIONAL: Configuring WebServer:
In case you want to make use of the built-in webserver, you will have to configure it.
In config.yml you have to add configure these fields:
HostAdress: Your host address (most likely the sameas the IP of the minecraft server.
HostPort: The port you want the webserver to run on (the default should be just fine in most cases).
EnableWebServer: Boolean value, do you want to use the webserver (you probably do, as you are reading this).

Example:
HostAdress: myawesomeserver.minecrafthost.com
HostPort: 5651
EnableWebServer: true

>?> How do I know if the webserver is working?
Everything in the Resources folder is hosted. Because Ambient.txt is always present, try to go to this address:
http://HostAdress:HostPort/Ambient.txt

Example:
http://myawesomeserver.minecrafthost.com:5651/Ambient.txt

If you see the contents of your Ambient.txt file, then congratulations, it's working! (Note that Ambient.txt may be empty if you didn't add anything to it.)

"="-key is used to open the overlay by default.

A collection of posts about the functionality + configuration:

MusicArea's (to be implemented) will have such a feature if you feel like it's a useful feature . The current sound effects are really meant for ambient sound EFFECTS, but there is no reason it shouldn't work for some gregorian music in a cathedral , or a greensleeves song in a tavern .

Currently, the sound effects work in a certain fashion: The custom sound effect is played for everybody in the server at the same time, to reduce the resources the plugin needs dramatically. A downside to this is that if you join the server, you may not hear the ambient sound effect yet, as you must wait for the next custom sound effect to play for you.

The way I currently implemented it: If you join a server, and you are not in a sound area, it will play the sound effect anyhow (for you personally). So there is a possibility, that if you just join a server, walk into a different effectloop area, your personal & the global sound effect will overlap.. I have thought of making them per-user, but I think that just won't be worth the resources for that unlikely problem .

Because they are global, I can not make an intro, after which it goes into loop-mode. For MusicArea's this will be possible though. I will try to make them as configurable as is desired by server hosts .

AmbientSpout

Free Version | BukkitDev

This plugin adds custom ambient music to your server. Players can turn this on and off. There is also a widget that is toggle-able and the possibility for users to use their own music link. After a song has stopped playing, the next song will start.

Demonstration of this plugin.

How to use:

In config.yml you find a list, which is initially empty, where you enter the following information; the duration of the song and the link to it. The format can only be .ogg or .wav ! You can add as many songs as you like.

Example config.yml

Code:

DebugMode: false
Ambient:
- 146 http://dl.google.com/u/JustAnExample.ogg
- 169 http://dl.google.com/u/JustAnotherExample.ogg
- 123 http://dl.google.com/u/JustAnotherExampleAgain.ogg

Dependencies:

• Spout serverside.
• SpoutCraft clientside(if the player wants to use this plugin).

Features:

• Easy to configure.
• Lightweight.
• Permissions-based.
• Hotkey configurable in SpoutCraft

Downloads:

Free Version

How does it help my plugin?

Plugin-wise, in absolutely no way.

Then why on Earth would I donate?

Time and effort was put into this plugin. Maybe this plugin makes your life easier, gets your server more players or simply makes you and the players have a good time.

How do I donate?

You can donate through PayPal. If you do not have the means to do so, you can also "donate" by showing your appreciation in the form of a nice comment. These donations and comments keep me motivated. Oh, and it keeps me alive in this overpriced studentroom I live in. It means the world to me.

Thank you for reading this.

Changelog

Version 0.1

• Initial release.

Any feedback is more than welcome!