BukkitHTTPD

Dummy

BukkitHTTPD

http://img836.imageshack.us/img836/8580/bukkithttpdbd.png

Faster then ever!

Overview

This is a continuation of BukkitHTTPD from codename_B.

Installation

  • Put the BukkitHTTPD.jar in Bukkits plugins folder.
  • Start up the server.
  • Change the index.html.page
  • Have a look at the <yourServerIP>:8107/test.v10 page and it's sources to see how to use the server-side scripting language.
  • Change the test.v10 page.
  • Add as many other pages as you want.

Configuration

The configuration can be found in the file plugins/BukkitHTTPD.yml.

After the first server startup you can configure it in-game (see Commands) or edit the file and reload it (see Commands/Reload).

You can also change the banner background by editing the BukkitHTTPD.jpg file in the web folder.

Commands

Use the following commands to configure the httpd server on the fly:

Port

"/httpd port" to view the server port or

"/httpd port newPort" to set the server port to "newPort" or (this is for the banner)

"/httpd port hide" to toggle the server port hide feature.

Banner

"/httpd banner" to toggle the banner switch.

This switch decides if the banner will be created or not.

Color

This is for the banners text color: "/httpd color" to view the color or

"/httpd color newColor" to change the color to "newColor".

Refresh

"/httpd refresh 60 to set the banner refresh time to 60 seconds (1 minute).

Plugins

"/httpd plugins to toggle the plugins switch.

This switch decides if plugins are shown on the banner.

Directory

"/httpd dir" to view the www folder or

"/httpd dir new/folder/" to change it to "new/folder/".

PHP

"/httpd php" to toogle PHP support.

"/httpd php /path/to/php.exe" path to the php(-cli) executable.

Bans

"/httpd bans" to toogle the minecraft ban feature.

This feature uses minecraft bans for the http access, too.

Admin

"/httpd admin playerName"

This toogles playerNames web admin state, used to administrate the minecraft server through the web browser. See V10 scripting language for more details.

Error

"/httpd error 404" to show the current 404 error page.

"/httpd error 403" to show the current 403 error page.

"/httpd error number file" to set the number error page to file.

v10, php and vhp files supported!

Reload

"/httpd reload" to reload the configuration from disk.

Password

"/httpd password pwd" to set your httpd password to "pwd".

"/httpd rmpwd user" to delete the password of user "user".

Update

"/update BukkitHTTPD" to update this plugin. Have a look here for more information.

Permissions

All httpd commands are secured with this superPerms node:

  bukkithttpd.admin:
    description: Administrate BukkitHTTPD.
    default: op

except the /httpd password command, which is secured with this one instead:

  bukkithttpd.user:
    description: Be able to change your BukkitHTTPD password.
    default: true
  autoupdate.announce:
    description: Users with this node will be notified about new updates.
    default: op
  autoupdate.update.bukkithttpd:
    description: Users with this node will be able to use /update this plugin.
    default: op

for more information about the autoupdate nodes have a look here.

V10 scripting language

Have a look at this page.

PHP

Set up PHP.

BukkitHTTPD uses the cli version of php (not tested with the cgi version), keep that in mind (different configs, ...)!

You can have a custom php.ini for BukkitHTTPD, simply save it into your bukkits folder (not the plugins folder!). But a few config values are hardcoded.

There's a new file extension, too: vhp. vhp files will get parsed for the V10scripting language and PHP (in that order).

The global php variables are slightly different. There's no $_POST or $_GET, it's all in $argv (and $_SERVER['argv']). Also the $_FILE array has changed. there's only $_FILE['*']['name'] and $_FILE['*']['tmp_name']. This is no longer the case since v0.2 That's the bad news, now the good: There's a new array: $_MINECRAFT ! :)

Please note that you should use .v10 files instead of .php or .vhp whenever you can, simply to reduce the math done on the server.

Integrated chat

To use the integrated chat simply access your BukkitHTTPD url and attach /chat to it. Example:

myBukkitServer:8107/chat

don't forget to set a httpd password first! :)

Since 0.1.5 web admins can reload and shutdown the server from the chat interface, too.

Banner

BukkitHTTPD will create a nice-looking banner for you. Example: BukkitHTTPD example banner You'll find it as banner.png in your www folder. To change the background simply change the BukkitHTTPD.jpg file in the same directory.

Custom error pages

BukkitHTTPD supports custom pages for the 403 and 404 HTTP errors.

See Configuration for more information.

Thanks

  • To codename_B for his awesome work.
  • To the original authors of NanoHTTPD, which is the base of this plugin. This is no longer the case since v0.2
  • To Luficer for updating the html/v10 files of the integrated chat.

License

This plugin is licensed under the GPLv3 and has it's sources included in the jar. With one exception: The files "NanoHTTPD.java" and "NanoHTTPD.class" which aren't present anymore since v0.2 are licensed under the NanoHTTPD License, which you can read here:

Copyright (C) 2001,2005-2011 by Jarno Elonen <[email protected]> and Copyright (C) 2010 by Konstantinos Togias <[email protected]>

Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:

Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. The name of the author may not be used to endorse or promote products derived from this software without specific prior written permission.

THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

You must login to post a comment. Don't have an account? Register to get one!

  • Avatar of monkeymanboyperson monkeymanboyperson Feb 23, 2013 at 23:06 UTC - 1 like

    I suggest adding a feature so that the chat can be a voice thing where people can have a brower behind minecraft with the chat so people don't have to download anything like mumble or teamspeak

    BFAK:90671956,112e88b6b8126ccd209c6857ae896a25e3e8d392b0bdfdb3abbe9abbc9039327

  • Avatar of Shad0wSpl1c3r Shad0wSpl1c3r Jan 16, 2013 at 21:00 UTC - 0 likes

    @V10lator: Go

    Goodbye? You aren't updating this plugin anymore? :c Nooooo.

    Vanwa-Arda Banner

  • Avatar of V10lator V10lator Dec 14, 2012 at 01:28 UTC - 0 likes

    If you want to help developing: Read this first!

    Like what you see? Feel free to donate (or send me BitCoins: 16nL7XgC7DefPcBVzPBwkSV7YD6vJGZUjh )

  • Avatar of speaw speaw Nov 06, 2012 at 22:01 UTC - 0 likes

    whitelist system pls

  • Avatar of Robbendebiene Robbendebiene Oct 23, 2012 at 15:30 UTC - 0 likes

    Hi V10lator, very nice plugin, I've been searching so long for an functionaly webchat plugin. But, i've a little problem. Sometimes i can't login (yes i set and write in the right password) and get this error:

    V10parse error: 5: Permissions error: Wrong password!

    or sometimes i'm logged in write/send some words and then i'll got this error again. pls help (seems like i'll get logged out after some seconds.)

    Kind regards Robben

    Plugin page Donate

  • Avatar of V10lator V10lator Oct 11, 2012 at 05:42 UTC - 0 likes

    @pimsserver: Go At the DL page ( http://dev.bukkit.org/server-mods/bukkithttpd/files/25-v0-2-5/ ) read the known caveats, cause you're running the wrong Java version.

  • Avatar of pimsserver pimsserver Oct 11, 2012 at 05:34 UTC - 0 likes

    BukkitHTTPD: 0.2.5 Spigot: 150 (implementing API version 1.3.2-R1.1)

    http://pastebin.com/apDBNTaF

  • Avatar of Luficer Luficer Oct 08, 2012 at 12:48 UTC - 0 likes

    Just wanted to post this error: http:dev.bukkit.org/paste/6361/

    (Not sure what prompted the error tbh)

    Also included the updater message since it seems bugged a bit still (says there's an update to the current version from the current version).

    I'm sure you've noticed, but going from the chat to the game, spaces and probably symbols are gone/replaced with "+", such as this:

    06:39:02 [INFO] OffLuffy> some+random+text+
    
  • Avatar of V10lator V10lator Oct 06, 2012 at 20:00 UTC - 0 likes

    @Cecelo126: Go Please give me the full stacktrace, cause knowing where something may be wrong but not what exactly (NullPojnterexception, ArrayOutOfrRangeException, ...) isn't good to fix it.

  • Avatar of Cecelo126 Cecelo126 Oct 06, 2012 at 10:39 UTC - 0 likes

    Hey, could you please tell me why when I write in the chat symbols doesn't appear and it changes the spaces with +?

    In the console appears THIS D:

Facts

Date created
Oct 14, 2011
Categories
Last update
Oct 09, 2012
Development stage
Release
License
GNU General Public License version 3 (GPLv3)
Curse link
BukkitHTTPD
Downloads
16,090
Recent files
  • R: v0.2.5 for CB 1.3.2-R1.0 Oct 09, 2012
  • R: v0.2.4 for CB 1.2.5-R4.0 Jul 13, 2012
  • R: v0.2.3 for CB 1.2.5-R4.0 Jul 04, 2012
  • R: v0.2.2 for CB 1.2.5-R4.0 Jul 04, 2012
  • R: v0.2.1 for CB 1.2.5-R4.0 Jul 04, 2012

Authors