Mirror von
https://github.com/IntellectualSites/FastAsyncWorldEdit.git
synchronisiert 2024-12-25 02:20:07 +01:00
Minors
Dieser Commit ist enthalten in:
N0tMyFaultOG
Ursprung
0a28059792
Commit
5b38172821
1076
CHANGELOG.txt
1076
CHANGELOG.txt
Datei-Diff unterdrückt, da er zu groß ist
Diff laden
@ -1,69 +0,0 @@
|
|||||||
Contributing
|
|
||||||
============
|
|
||||||
|
|
||||||
Thank you for your interest in contributing to WorldEdit! We appreciate your
|
|
||||||
effort, but to make sure that the inclusion of your patch is a smooth process, we
|
|
||||||
ask that you make note of the following guidelines.
|
|
||||||
|
|
||||||
* **Follow the [Oracle coding conventions](http://www.oracle.com/technetwork/java/codeconv-138413.html).**
|
|
||||||
We can't stress this enough; if your code has notable issues, it may delay
|
|
||||||
the process significantly.
|
|
||||||
* **Target Java 7 for source and compilation.** Make sure to mark methods with
|
|
||||||
` @Override` that override methods of parent classes, or that implement
|
|
||||||
methods of interfaces.
|
|
||||||
* **Use only spaces for indentation.** Our indents are 4-spaces long, and tabs
|
|
||||||
are unacceptable.
|
|
||||||
* **Wrap code to a 120 column limit.** We do this to make side by side diffs
|
|
||||||
and other such tasks easier. Ignore this guideline if it makes the code
|
|
||||||
too unreadable.
|
|
||||||
* **Write complete Javadocs.** Do so only for public methods, and make sure
|
|
||||||
that your `@param` and `@return` fields are not just blank.
|
|
||||||
* **Don't tag classes with @author.** Some legacy classes may have this tag,
|
|
||||||
but we are phasing it out.
|
|
||||||
* **Make sure the code is efficient.** One way you can achieve this is to spend
|
|
||||||
around ten minutes to think about what the code is doing and whether it
|
|
||||||
seems awfully roundabout. If you had to copy the same large piece of
|
|
||||||
code in several places, that's bad.
|
|
||||||
* **Keep commit summaries under 70 characters.** For more details, place two
|
|
||||||
new lines after the summary line and write away!
|
|
||||||
* **Test your code.** We're not interested in broken code, for the obvious reasons.
|
|
||||||
* **Write unit tests.** While this is strictly optional, we recommend it for
|
|
||||||
complicated algorithms.
|
|
||||||
|
|
||||||
|
|
||||||
Checklist
|
|
||||||
---------
|
|
||||||
|
|
||||||
Ready to submit? Perform the checklist below:
|
|
||||||
|
|
||||||
1. Have all tabs been replaced into four spaces? Are indentations 4-space wide?
|
|
||||||
2. Have I written proper Javadocs for my public methods? Are the @param and
|
|
||||||
@return fields actually filled out?
|
|
||||||
3. Have I `git rebase`d my pull request to the latest commit of the target
|
|
||||||
branch?
|
|
||||||
4. Have I combined my commits into a reasonably small number (if not one)
|
|
||||||
commit using `git rebase`?
|
|
||||||
5. Have I made my pull request too large? Pull requests should introduce
|
|
||||||
small sets of changes at a time. Major changes should be discussed with
|
|
||||||
the team prior to starting work.
|
|
||||||
6. Are my commit messages descriptive?
|
|
||||||
|
|
||||||
You should be aware of [`git rebase`](http://learn.github.com/p/rebasing.html).
|
|
||||||
It allows you to modify existing commit messages, and combine, break apart, or
|
|
||||||
adjust past changes.
|
|
||||||
|
|
||||||
Example
|
|
||||||
-------
|
|
||||||
|
|
||||||
This is **GOOD:**
|
|
||||||
|
|
||||||
if (var.func(param1, param2)) {
|
|
||||||
// do things
|
|
||||||
}
|
|
||||||
|
|
||||||
This is **EXTREMELY BAD:**
|
|
||||||
|
|
||||||
if(var.func( param1, param2 ))
|
|
||||||
{
|
|
||||||
// do things
|
|
||||||
}
|
|
||||||
197
README.html
197
README.html
@ -1,197 +0,0 @@
|
|||||||
<!DOCTYPE html>
|
|
||||||
<html>
|
|
||||||
<head>
|
|
||||||
<title>${project.name} ${version}</title>
|
|
||||||
<link href="http://fonts.googleapis.com/css?family=Source+Sans+Pro:400,700|Ropa+Sans" rel="stylesheet" type="text/css">
|
|
||||||
<style>
|
|
||||||
body {
|
|
||||||
margin: 0;
|
|
||||||
padding: 3em 1em;
|
|
||||||
background: #efefef;
|
|
||||||
color: #333;
|
|
||||||
line-height: 1.5;
|
|
||||||
}
|
|
||||||
#wrapper {
|
|
||||||
width: 600px;
|
|
||||||
margin: auto;
|
|
||||||
}
|
|
||||||
body, th, td, input {
|
|
||||||
font: 14px 'Source Sans Pro', Arial, sans-serifsans-serif;
|
|
||||||
}
|
|
||||||
.section {
|
|
||||||
background: #fff;
|
|
||||||
position: relative;
|
|
||||||
padding: 2em 2.4em;
|
|
||||||
margin: 3em auto 4em auto;
|
|
||||||
width: 80%;
|
|
||||||
-webkit-box-shadow: 0 1px 4px rgba(0, 0, 0, 0.1);
|
|
||||||
-moz-box-shadow: 0 1px 4px rgba(0, 0, 0, 0.1);
|
|
||||||
box-shadow: 0 1px 4px rgba(0, 0, 0, 0.1);
|
|
||||||
}
|
|
||||||
.section:before, .section:after {
|
|
||||||
content: "";
|
|
||||||
position: absolute;
|
|
||||||
z-index: -2;
|
|
||||||
}
|
|
||||||
.section {
|
|
||||||
-moz-border-radius: 4px;
|
|
||||||
border-radius: 4px;
|
|
||||||
}
|
|
||||||
.section:before, .section:after {
|
|
||||||
bottom: 15px;
|
|
||||||
left: 10px;
|
|
||||||
width: 50%;
|
|
||||||
height: 20%;
|
|
||||||
max-width: 300px;
|
|
||||||
max-height: 100px;
|
|
||||||
-webkit-box-shadow: 0 15px 10px rgba(0, 0, 0, 0.5);
|
|
||||||
-moz-box-shadow: 0 15px 10px rgba(0, 0, 0, 0.5);
|
|
||||||
box-shadow: 0 15px 10px rgba(0, 0, 0, 0.5);
|
|
||||||
-webkit-transform: rotate(-1deg);
|
|
||||||
-moz-transform: rotate(-1deg);
|
|
||||||
-ms-transform: rotate(-1deg);
|
|
||||||
-o-transform: rotate(-1deg);
|
|
||||||
transform: rotate(-1deg);
|
|
||||||
}
|
|
||||||
.section:after {
|
|
||||||
right: 10px;
|
|
||||||
left: auto;
|
|
||||||
-webkit-transform: rotate(1deg);
|
|
||||||
-moz-transform: rotate(1deg);
|
|
||||||
-ms-transform: rotate(1deg);
|
|
||||||
-o-transform: rotate(1deg);
|
|
||||||
transform: rotate(1deg);
|
|
||||||
}
|
|
||||||
a:link, a:visited {
|
|
||||||
color: #0004b2;
|
|
||||||
text-decoration: none;
|
|
||||||
}
|
|
||||||
a:hover {
|
|
||||||
color: #ac0000;
|
|
||||||
text-decoration: none;
|
|
||||||
border-bottom: 1px solid #999;
|
|
||||||
}
|
|
||||||
h1 {
|
|
||||||
font: 2.7em 'Ropa Sans', 'Trebuchet MS', Helvetica, Arial, sans-serif;
|
|
||||||
color: #000;
|
|
||||||
margin: 0 0;
|
|
||||||
padding: 0 0 0.2em 0;
|
|
||||||
font-weight: normal;
|
|
||||||
text-align: center;
|
|
||||||
text-shadow: 2px 2px #FFF;
|
|
||||||
}
|
|
||||||
h2 {
|
|
||||||
font-size: 1.3em;
|
|
||||||
color: #FFF;
|
|
||||||
margin: -2.5em 0 0.8em 0;
|
|
||||||
float: left;
|
|
||||||
background: #FF6900;
|
|
||||||
padding: 0.4em 0.8em;
|
|
||||||
border-radius: 0.2em;
|
|
||||||
font-weight: normal;
|
|
||||||
text-align: center;
|
|
||||||
}
|
|
||||||
h3 {
|
|
||||||
text-transform: uppercase;
|
|
||||||
font-weight: bold;
|
|
||||||
}
|
|
||||||
h2 + * {
|
|
||||||
clear: both;
|
|
||||||
}
|
|
||||||
@media (max-width: 650px) {
|
|
||||||
#wrapper {
|
|
||||||
width: 100%;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
</style>
|
|
||||||
</head>
|
|
||||||
<body>
|
|
||||||
|
|
||||||
<div id="wrapper">
|
|
||||||
<h1>${project.name} ${version}</h1>
|
|
||||||
<div class="section">
|
|
||||||
<h2>Getting Started</h2>
|
|
||||||
<p>
|
|
||||||
Thanks for choosing ${project.name}! When you first install ${project.name},
|
|
||||||
no one will be able to do anything until you give permissions (unless everyone is an op).
|
|
||||||
Because ${project.name} is largely command-driven, it has no effect until
|
|
||||||
someone uses its commands, you can install WorldEdit and deal with
|
|
||||||
configuration whenever you are ready.
|
|
||||||
</p>
|
|
||||||
<ul>
|
|
||||||
<li><a href="http://wiki.sk89q.com/wiki/${project.name}/Installation">How do I install ${project.name}?</a></li>
|
|
||||||
<li><a href="http://wiki.sk89q.com/wiki/${project.name}/Upgrading">How do I update ${project.name}?</a></li>
|
|
||||||
<li><a href="http://wiki.sk89q.com/wiki/${project.name}#Usage">How do I use ${project.name}?</a></li>
|
|
||||||
</ul>
|
|
||||||
<p>
|
|
||||||
Need help?
|
|
||||||
<a href="http://wiki.sk89q.com/wiki/${project.name}/Support">See the ways that you can get assistance</a>.
|
|
||||||
</p>
|
|
||||||
</div>
|
|
||||||
<div class="section">
|
|
||||||
<h2>Common Issues</h2>
|
|
||||||
|
|
||||||
<h3>I or others don't have permission to build.</h3>
|
|
||||||
<p>
|
|
||||||
This is not a problem caused by ${project.name}.
|
|
||||||
${project.name} doesn't deny build permissions as it is merely
|
|
||||||
a world editing program.
|
|
||||||
</p>
|
|
||||||
|
|
||||||
<h3>${project.name} doesn't seem to work.</h3>
|
|
||||||
<p>
|
|
||||||
A common mistake is making
|
|
||||||
a syntax error in one of ${project.name}'s configuration files (this is very
|
|
||||||
fatal unfortunately, and can be caused by a single character typed in the wrong place). Try
|
|
||||||
<a href="http://wiki.sk89q.com/wiki/${project.name}/Support">asking in IRC</a>
|
|
||||||
to see whether anyone can help you.
|
|
||||||
</p>
|
|
||||||
|
|
||||||
<h3>Can I use this with mod blocks?</h3>
|
|
||||||
<p>
|
|
||||||
Yes, <a href="http://wiki.sk89q.com/wiki/WorldEdit/Introduction#Block_support">depending on what you are using WorldEdit with</a>
|
|
||||||
(Bukkit, Single Player Commands, MinecraftEdu, etc.). We don't guarantee
|
|
||||||
100% compatibility with all known custom blocks,
|
|
||||||
<a href="http://www.youtube.com/watch?v=FkCtjBL-7vs">but we have pretty
|
|
||||||
decent support</a>. Please be aware that support for these mods is
|
|
||||||
considered 'experimental,' and will likely be for the far forseeable
|
|
||||||
future.
|
|
||||||
</p>
|
|
||||||
|
|
||||||
<h3>How do I protect my spawn?</h3>
|
|
||||||
<p>
|
|
||||||
You'll have to install our accompanying WorldGuard plugin, which works
|
|
||||||
in conjunction with ${project.name} in order to protect areas. With it,
|
|
||||||
you can make a selection with WorldEdit and then 'define' a region
|
|
||||||
that prevents other from building in it.
|
|
||||||
</p>
|
|
||||||
|
|
||||||
<h3>Can I use ${project.name}'s selections in my Bukkit plugin?</h3>
|
|
||||||
<p>
|
|
||||||
Absolutely! We haven't documented how to yet, but you can try
|
|
||||||
looking at the <a href="http://docs.sk89q.com/worldedit/apidocs/com/sk89q/worldedit/bukkit/WorldEditPlugin.html">Javadocs</a>
|
|
||||||
for the plugin's main class. You'll have to get a reference to WorldEdit
|
|
||||||
from Bukkit's plugin manager (don't try to create WorldEditPlugin), and then
|
|
||||||
call one of its selection methods.
|
|
||||||
</p>
|
|
||||||
|
|
||||||
<p>
|
|
||||||
Still need help?
|
|
||||||
<a href="http://wiki.sk89q.com/wiki/${project.name}/Support">See the ways that you can get assistance</a>.
|
|
||||||
</p>
|
|
||||||
</div>
|
|
||||||
<div class="section">
|
|
||||||
<h2>Contributing</h2>
|
|
||||||
<p>
|
|
||||||
Did you know that ${project.name} is open source? That means that you can
|
|
||||||
read the code and learn from it, as well as modify it and submit back
|
|
||||||
changes to help the community!
|
|
||||||
</p>
|
|
||||||
<ul>
|
|
||||||
<li><a href="https://github.com/sk89q/worldedit">View the source code</a></li>
|
|
||||||
<li><a href="http://wiki.sk89q.com/wiki/${project.name}/Development">More information</a></li>
|
|
||||||
</ul>
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
</body>
|
|
||||||
</html>
|
|
||||||
Laden…
In neuem Issue referenzieren
Einen Benutzer sperren