[WEB/ADMN] - Webukkit v0.beta9.5-fix3

Discussion in 'Bukkit Tools' started by cyberbobjr, Feb 12, 2011.

Thread Status:
Not open for further replies.
  1. Offline


    Version: v0.9.5-fix3
    Webukkit is a http interface for Bukkit.

    • Stats pages : top 10 builders, killers, travelers, etc. based on the Stats Plugin
    • GUI Plugins (see screenshots) for :
      • Permissions plugin
      • Achievements plugins
    • Show a map of your world (with an url like dynmap or a image file like mcmap)
    • Show/modify/backup your plugins configuration files
    • Access to some commands of TCP Plugin (http://forums.bukkit.org/threads/admin-dev-tcp-interface-for-bukkit-v1-1-297.746/) :
      • Send a message to a connected player
      • Send a message to all players connected
      • Kick a player
      • Display player's inventory
      • Destroy an item in the player's inventory
      • Give item to a player
    • Access to Remote Toolkit Plugin (http://forums.bukkit.org/threads/ad...view-full-remote-console-access-r10-a7-1.674/) :
      • Restart server
      • Restart forced server
      • Stop server
      • Stop Minecraft server
      • Start Minecraft server
      • Send console command and watch the result (ban, kick, op, deop, deban, etc.)
    • Interaction with Permissions plugin : allows users to register and be automatically listed in the Permissions plugin with a choosen world and a choosen group
    • Access to the server log
    • Theme support, you can made your own theme ! (Minecraft theme is provided, see screenshots)
    • Permissions for the website : ability to access map & stats pages for public/registered users
    Planned/Todo :

    - Edit profile for users : add avatar option for stats pages - (not started yet, planned for the 1.0)
    - Signature generator : make signature with player's stats - (not started yet, planned for the 1.0)
    - GUI for GroupManager : i'm waiting for the YAML fix or for the SQLite version of GM...
    - Mini blog engine : add posts and comments in the Public interface (not started yet, maybe for the 1.0 version)
    - Replace TCP Remote Plugin by my own plugin : RemoteTCP (http://forums.bukkit.org/threads/dev-remotetcp-v1-0-crypted-server-query-602.10506/), more secure, more faster.


    You will need :
    • HTTP server with mod_rewrite support
    • MySQL 5
    • PHP 5.2 or greater (or PHP 5 but with json package)
    Download (open)

    You can download the archive here : http://code.google.com/p/bukkit-webadmin/downloads/list

    You can access the source code here : http://code.google.com/p/bukkit-webadmin/source/checkout

    Screenshots (open)

    Webukkit permissions (Theme : minecraft)
    Gui for Achievements (Theme : minecraft)
    Stats page (with Stats plugin) (Theme : minecraft)
    Installation Windows
    Connexion Windows
    Configuration Windows
    Map Windows (with dynmap)
    Map Windows (with integrated viewer - mcmap example)
    Log Windows
    Plugin Editor Windows
    Status Windows : Server command & Player command & Player inventory
    GUI for Permissions plugin

    Installation (open)

    A tutorial was write for installation, look at this : Tutorial step 1

    You must have an HTTP server AND a MySQL base AND PHP Version >5.2 (for json thanks to zajacmp3 ;))
    1. Unzip the archive in your html root folder.
    2. Go to http://yourserver/index.php/installer/ and follow instructions.
    Linux Users, attention :
    • The files unzipped must be owned by the apache group !
    • If you want to modify config file for plugins, the minecraft directory must be writable by the apache group !
    Install these scripts to the same server that host Minecraft if you want to edit config files of plugins.

    If you want to use TCP Bukkit Interface, it's must be configured with this option :

    Upgrade to 0.7 (open)

    From 0.5beta : please don't do an upgrade with the 0.5beta, it's better to do a fresh install.
    From 0.6beta : is not necessary, uncompress the 0.7beta archive and run it's enough.

    Instructions :

    1. Unzip the archive into your Bukkit Webadmin directory (be careful to the rights)
    2. Go to http//yourserver/updater and generate the tables you don't have.

    Interaction with Permissions plugin (open)

    I've tested this functionnality with Permissions Plugin 2.1.
    Be carefull : do a backup of your config file "yml" before.

    This functionnality let your users to register on the site and automaticaly be added to the Permissions Plugin.
    You choose the default group and default world for new users.
    This functionnality is not mandatory, it's an option, you can choose to activate it or not.

    For enabling this functionnality, go in the config menu, check "Use Permissions plugin" and choose the default world and default group. The group list is calculated dynamically on the configuration file of Permissions plugin.

    Each time a user registers on the site, a new entry is added into config "yml" file of Permissions plugins. If you use the Nukkit plugin (http://forums.bukkit.org/threads/ad...-web-based-authentication-and-promotion.4631/) the permissions will be automatically reloaded, if not you must reload manually configuration of Permissions plugin.
    If you want to reload automatically permissions plugins, click on the chekbox "Reload permissions after new register ?" (warning it's experimental). You must have RemoteToolkit Plugin enabled and correctly configured.

    How to made your own theme (open)

    Theme files must be in the directory /theme
    The name of the directory will be the name of your theme, it will be visible in the config menu.
    In your theme directory, make CSS and IMG directory.
    Inside CSS, put your ... CSS files :) You must have 3 CSS :
    • "default.css" - General CSS for the website
    • "jquery-ui-1.8.9.custom.css" - You can generate CSS at this url : http://jqueryui.com/themeroller/
    • "selectmenu.css" - CSS for the dropdown langage selector
    Inside IMG, put all images files necessary for your theme.

    For example, you want to design a theme called "NochtheBest".
    Create a directory named "NochtheBest" in "Theme" directory.
    Create a CSS and IMG in "NochtheBest", copy your CSS and IMG files inside them.
    You will have :
    \ - Theme
    \ - NotchtheBest​
    \ - CSS​
    \ - IMG​

    Done! You can change your theme in the config menu to "NotchtheBest"

    Changelog (open)

    version 0.9.5-fix3 - 2011-04-16
    • Fix a bug with achievement editor
    • Fix a bug for the path of items.txt
    version 0.9.5-fix2 - 2011-04-14
    • Fix for Stats & Achievements v0.9
    version 0.9.5-fix1 - 2011-03-22
    • Remove test menu :p
    version 0.9.5 - 2011-03-21
    • Add SQL support for Stats & Achievements plugin
    • Add support for Stats & Achievements plugin v0.8
    • Fix a bug for a trailing slash in the main root url
    • Add singlequote instead of doublequote for YAML config file
    version 0.beta9 - 2011-03-13
    • Add theme support
    • Add permissions for website (for stats & map)
    • Add stats pages (with Stats plugin)
    • Add group and user management for webukkit
    • Add GUI for Achievements plugin
    • Add an option for reloading Permissions plugin when a user is registered (experimental)
    • Full french translation
    version 0.beta8 - 2011-03-11
    • Add a php version check for the installer
    • Add a langage selector (French is translated "petit à petit") - Thanks to Amrac !
    • Add a GUI for Permissions plugins
    • Modify the registration system for new users into Permissions plugins, add the world option
    • Fix a bug with trailing slash in the minecraft path
    • Fix a bug in core.php for the UTC time zone
    Version 0.beta7 - 2011-03-01
    • The name is now "Webukkit" instead of "Webadmin Bukkit"
    • Subdirectory feature : you can now install Webukkit in a subdirectory instead of a root web directory
    • Add an edit button for editing template plugin
    • Fix a bug images displayed in inventory when you use subdirectory
    • Add a log windows : now you can see the log server.
    • You can send command to the console in the "log" menu (be careful it's experimental, use it at your own risk).
    • Add another map system, you can now use a standard image file for displaying map instead of a url for dynmap (the image file must be stored in /maps/images)
    • Ajax request don't block the windows now, a simple "wait cursor" is now displayed when an Ajax request is made
    Version 0.beta6 - 0211-02-24
    • Fix a bug when the plugin name contain a space, the plugin tab did not display the config file.
    • In the installer, you can now choose if you want to create a database or use a existing one, you can also set the prefix for tables.
    • You don't need anymore to be root of the database for creating tables and inject data, a valid account with privilege is enough.
    • Add licence information
    • Add "hold" and "unhold" command for Remote toolkit
    • Automaticaly add registered users to Permissions Plugin with a default choosen group (it's an option, you can uncheck this feature if you want)
    • Add some verifications check in the register panel
    • Add user management in the config tab
    • Add a button in the 'Edit plugin' menu for deleting old config file
    • Add new items from the Minecraft 1.3 version
    Version 0.beta5 - 2011-02-21
    • Remove the rewriting process, no more .htaccess !
    • Major change in directories structures
    • Add a user registration (for later)
    • Various minors fixes and checks
    Version 0.beta4 - 2011-02-18
    • Add Remote toolkit support (it's now possible to restart the server)
    • Add UTF-8 support for config file (Gastronomic plugin for example)
    • During the update it is now possible to import new templates plugins
    • During the installation, the "tmp" directory AND subdirectories are write-checked
    • CSS cleaning
    • Remove some useless function (the status windows display faster now)
    • Windows in the inventory panel are moveable
    • All always, some minors bugs fixed
    Version 0.beta3 - 2011-02-16
    • Add inventory management
    • Change the status windows
    • Add a check for installation for security (if a file exist, you can't install anymore)
    • Add an updater processus
    Version 0.beta2 - fix 2
    • Add verification of permissions in the installer process and the config process.
    Version 0.beta2 - fix 1
    • Many littles fixes for Linux system
    Version 0.beta2
    • First release to the public

    0.beta9.5 is still free, but you can donate.

    v1.0 will cost 5€ when it will be done.


    PS : sorry for my bad English, i'm a French native ;)

    Thanks to MonsieurApple for his Minelink PHP Class (http://forums.bukkit.org/threads/minelink-0-1.3564/)

    Tested on :
    Windows 7 - Xampp 1.7.3
    Windows XP - Xampp 1.7.3
    Linux ClearOS 5.1 - Apache/PHP 5/MySQL 5.2
    Centos 5.3 - You must upgrade PHP to 5.2 => http://wiki.centos.org/HowTos/PHP_5.1_To_5.2

    Tested with :
    CraftBukkit build 617
    Permissions plugin 2.5.4
    TCP Plugins 1.2
    Remote Toolkit plugin r10 a8.2
    Stats & Achievements v0.9
  2. Offline


    Hi guys,
    Sorry, i've spend my day to add this enhancement but without success. It seems that you must use rewriting for this.
    My head is like a pumpkin now, big headache :'(. I'm working on other functionnality now, to rest...
    --- merged: Feb 22, 2011 2:27 PM ---
    After reflexion, i think to add this functionnality :
    in the check panel config, you can indicate if the database exist or not, and you could indicate prefix of tables too.
    When you click on the "check config" :
    if the field database is empty, the database "bukkitadmin" will be created. It the field database is not empty, only the tables with prefix will be created.
    What do you think about this ?
  3. Offline


    This sounds good to me. I started to rewrite the code to make use of a pre-exsisting database but don't have a lot of time to work on it right now and unfortunately I won't be able to use this until it can make use of one.

    Thanks for all of your work on this! It looks great and I'm looking forward to be able to use it!
  4. Offline


    Which php file is the one that redirects you to login if you are not logged in? I would like to change this so instead of my users going to login when they go to my site there would be a login link for me but they get to see at least one page of a website
  5. Offline


    Oh hey :eek: I got it working in a sub directory. Cool. I think it was just my mistake at first :p
  6. Offline


    TELL ME HOW! Please? :p
  7. Offline


    Yeah, i'm interested too :)
    --- merged: Feb 22, 2011 10:34 PM ---
    For this you need to modify the route of the apps. The route is configured in /app/config/routes.php
    the config file is like this :
    Router::connect('/', array('controller' => 'Public''action' => 'index'));
    If you want that / redirect to a page, you can replace it :
    $Route->connect('/', array('controller' => 'pages''action' => 'display''home'));
    The "display.ctp" and "home.ctp" must be in /app/views/pages/
    The "display.ctp" and "home.ctp" will be wrapped by /app/views/layout/default.ctp (it's a template)

    Don't hesitate to ask me questions.

    Edit : another solution, but not fully tested : you rename the file index.php to index2.php for example. And you put your own index.php. The main login interface will be http://yourserver/index2.php.
  8. Offline


    Ever try to install, but after installing the DB and Log Settings window, since the plug-in I can not still resolved.
  9. Offline


    I'm using Apache. I just created a folder in my main directory called "BukkitAdmin" and then coppied the code I got from here into that. I went to domain.com/BukkitAdmin/index.php/installer and followed the steps as normal and then when it finished I was redirected to domain.com/index.php so I just manually went back into the BukkitAdmin and put in the default admin and admin for username and password then went on like normal. The only thing is the plugins part isn't working.. I dunno if that's cause of it being in a different area then normal (Which I don't think so) or if I just didn't read that there's something going on with it up there? The TCP stuff is working fine and so is the map :D
  10. Offline


    Ok I am now really confused. Have never used cakePHP or whatever you use before. But the index2.php works fine, thanks.
    --- merged: Feb 23, 2011 3:14 AM ---
    Ya, that's what I had before but plugins didn't work. I think for now the only way for plugins is in the root webserver directory.
  11. Offline


    Hi JavaJosh,
    Thanks for your sharing, i'll look that today.

    EDIT : Well, don't work for me if i cannot copy "css"," js" and "img" folder into /app directory.
    For the plugins tabs : does all the plugins are empty ? or just plugin named "Minecraft server" ?
  12. Offline


    I just noticed this, very nice work!
    You will probably want to add support for the two new RemoteToolkit UDP commands: hold and unhold.
    These will stop and start the minecraft server respectively (without stopping the wrapper itself)
  13. Offline


    Hi Doctor,
    Thanks you, i'll add these in the next version.
  14. Um so this has to be on the server that you host minecraft?...
  15. Offline


    If you want to edit config plugins yes. If you just want to use TCP interface and/or Remote Toolkit no.
  16. Offline


    can it be converted to MsSql and Asp.net 4.0???
  17. Offline


    Hi, when will you release the non-root-access-needed and non-root-directory-needed version?
  18. Offline


    The version is ready :) maybe in 3-4 hours (i'm at work), i must do the usual use case tests.
    BUT the non-root-directory is not implemented, because you don't need to be root for using Webbukit, you only need that the directory CAN be read by apache user.

    The next version will include :
    Version 0.beta6 - 0211-02-24
    * Fix a bug when the plugin name contain a space, the plugin tab did not display the config file.
    * In the installer, you can now choose if you want to create a database or use a existing one, you can also set the prefix for tables.
    * You don't need anymore to be root of the database for creating tables and inject data, a valid account with privilege is enough.
    * Add licence information
    * Add "hold" and "unhold" command for Remote toolkit
    * Automaticaly add registered users to Permissions Plugin with a default choosen group (it's an option, you can uncheck this feature if you want)

    --- merged: Feb 24, 2011 12:32 PM ---
    It don't use MsSql but MySQL. Forgive my ignorance, but I thought that ASP.net was a language and not a database ?
  19. Offline


    When he says "root" he doesn't mean user, he means the root or base directory such as "www.example.com/". He/we would like to be able to put this in "www.example.com/bukkit-admin/" or something like that, which is currently not possible.
    It is. If i understand correctly, he would like the code ported to ASP.NET instead of PHP
  20. Offline


    Ok, thanks for your explanation ;) for the moment it's not my priority. I prefer to add functionnality for now.

    Not by me. But the code is open, the licence is GPLv3, everybody can take my job and do what he want.
  21. Offline


    Im having trouble to get this working i just get a white page.

    Even when i try to change the routes.php file it doesnt work because i think im missing the home.ctp file?
    It does work in the root directory tho but i dont want it there

  22. Offline


    For the moment, subdirectory is not yet supported. The webukkit only works in your html directory. After unzipping, your must go to http://yourserver/index.php/installer
  23. i cant login i tryed admin/admin aint working :S
  24. Offline


    This looks amazing! Great job, keep up the good work.
  25. Offline


    Hello im new to this and i think im doing something wrong :(

    When I try to set up the installation it doesnt connect to the Database.

    To be honest, I installed MYSQL and PHP but where can I setup a:
    Server Host
    Root Username

  26. Offline


    This is a fresh installation of MySQL and you don't know the root password ?
    Do you go to http://yourserver/index.php/installer ?

    Sorry, but i don't really understand what steps you have made.
  27. Offline


    I installed MySQL and I know the rootpassword
    But where can I find the Server Host or whats the name of it.
    --- merged: Feb 24, 2011 4:56 PM ---
    Is it possible that you look into it trough Teamviewer?
  28. Offline


    It's simple : it's the host which host the mysql database compared to the server which host the PHP scripts.
    If your database server is on the same server which host the PHP scripts, then the "server host" is "localhost".
  29. Offline


    I tried but it doesnt work :(



    Thanks :)
    --- merged: Feb 24, 2011 5:21 PM ---
    Is there a way to show the map on the webadmin?
  30. Offline


    Yeah with dynmap, but for the moment i think the actual version is down because of the new map file format for Minecraft 1.3.
    For the next version of Webukkit i'll add support for other map viewer. Promise :)
  31. Offline


    i like your work very much. seriously!
    You should really really implement subdirectory support. I run a Multigaming clan and i do not want to replace the homepage with a minecraft admin panel.
    certainly i am not the only one who has this opinion.
Thread Status:
Not open for further replies.

Share This Page