README.md
author alfadur
Thu, 20 Jun 2019 16:05:03 +0300
changeset 15190 9231247b1f83
parent 14962 947a4a4d2131
child 15284 7ab5cf405686
permissions -rw-r--r--
fix hammer and rcplane sprite offsets
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
12757
0e425574bd5f Update README.md: Add game description, controls, getting started guide for n00bs, fix typos, reorganize sections
Wuzzy <Wuzzy2@mail.ru>
parents: 12663
diff changeset
     1
Hedgewars - a turn-based strategy game
0e425574bd5f Update README.md: Add game description, controls, getting started guide for n00bs, fix typos, reorganize sections
Wuzzy <Wuzzy2@mail.ru>
parents: 12663
diff changeset
     2
======================================
14962
947a4a4d2131 Move build status higher
Anton Malmygin <antonc27@mail.ru>
parents: 14684
diff changeset
     3
[![Build Status](https://travis-ci.org/hedgewars/hw.svg)](https://travis-ci.org/hedgewars/hw)
12757
0e425574bd5f Update README.md: Add game description, controls, getting started guide for n00bs, fix typos, reorganize sections
Wuzzy <Wuzzy2@mail.ru>
parents: 12663
diff changeset
     4
0e425574bd5f Update README.md: Add game description, controls, getting started guide for n00bs, fix typos, reorganize sections
Wuzzy <Wuzzy2@mail.ru>
parents: 12663
diff changeset
     5
Description
0e425574bd5f Update README.md: Add game description, controls, getting started guide for n00bs, fix typos, reorganize sections
Wuzzy <Wuzzy2@mail.ru>
parents: 12663
diff changeset
     6
-----------
0e425574bd5f Update README.md: Add game description, controls, getting started guide for n00bs, fix typos, reorganize sections
Wuzzy <Wuzzy2@mail.ru>
parents: 12663
diff changeset
     7
This is the funniest and most addictive game you'll ever play—hilarious fun
0e425574bd5f Update README.md: Add game description, controls, getting started guide for n00bs, fix typos, reorganize sections
Wuzzy <Wuzzy2@mail.ru>
parents: 12663
diff changeset
     8
that you can enjoy anywhere, anytime. **Hedgewars** is a **turn-based strategy
0e425574bd5f Update README.md: Add game description, controls, getting started guide for n00bs, fix typos, reorganize sections
Wuzzy <Wuzzy2@mail.ru>
parents: 12663
diff changeset
     9
game** but the real buzz is from watching the **devastation caused by those
13000
d55aae479f50 Rewrite introduction in README
Wuzzy <Wuzzy2@mail.ru>
parents: 12999
diff changeset
    10
pesky hedgehogs** with those fantastic weapons—sneaky little blighters with
d55aae479f50 Rewrite introduction in README
Wuzzy <Wuzzy2@mail.ru>
parents: 12999
diff changeset
    11
a bad attitude!
12757
0e425574bd5f Update README.md: Add game description, controls, getting started guide for n00bs, fix typos, reorganize sections
Wuzzy <Wuzzy2@mail.ru>
parents: 12663
diff changeset
    12
0e425574bd5f Update README.md: Add game description, controls, getting started guide for n00bs, fix typos, reorganize sections
Wuzzy <Wuzzy2@mail.ru>
parents: 12663
diff changeset
    13
Each player controls a **team of up to 8 hedgehogs**. During the course of
0e425574bd5f Update README.md: Add game description, controls, getting started guide for n00bs, fix typos, reorganize sections
Wuzzy <Wuzzy2@mail.ru>
parents: 12663
diff changeset
    14
the game, players take turns with one of their hedgehogs. They then use
0e425574bd5f Update README.md: Add game description, controls, getting started guide for n00bs, fix typos, reorganize sections
Wuzzy <Wuzzy2@mail.ru>
parents: 12663
diff changeset
    15
whatever tools and weapons are available to **attack and kill the opponents'
13000
d55aae479f50 Rewrite introduction in README
Wuzzy <Wuzzy2@mail.ru>
parents: 12999
diff changeset
    16
hedgehogs**, thereby winning the game.
d55aae479f50 Rewrite introduction in README
Wuzzy <Wuzzy2@mail.ru>
parents: 12999
diff changeset
    17
d55aae479f50 Rewrite introduction in README
Wuzzy <Wuzzy2@mail.ru>
parents: 12999
diff changeset
    18
To destroy your foes you can use one out of **over 40 weapons**!
d55aae479f50 Rewrite introduction in README
Wuzzy <Wuzzy2@mail.ru>
parents: 12999
diff changeset
    19
Launch bazookas or homing bees, drop mines, dynamite or explosive rubber ducks,
d55aae479f50 Rewrite introduction in README
Wuzzy <Wuzzy2@mail.ru>
parents: 12999
diff changeset
    20
throw grenades or watermelon bombs, poison them with stinky cheese, send them
d55aae479f50 Rewrite introduction in README
Wuzzy <Wuzzy2@mail.ru>
parents: 12999
diff changeset
    21
flying with a baseball bat, and much more!
12757
0e425574bd5f Update README.md: Add game description, controls, getting started guide for n00bs, fix typos, reorganize sections
Wuzzy <Wuzzy2@mail.ru>
parents: 12663
diff changeset
    22
13000
d55aae479f50 Rewrite introduction in README
Wuzzy <Wuzzy2@mail.ru>
parents: 12999
diff changeset
    23
Most weapons cause **explosions that deform the terrain**, removing
d55aae479f50 Rewrite introduction in README
Wuzzy <Wuzzy2@mail.ru>
parents: 12999
diff changeset
    24
circular chunks. Hedgehogs can die by drowning, being thrown off
d55aae479f50 Rewrite introduction in README
Wuzzy <Wuzzy2@mail.ru>
parents: 12999
diff changeset
    25
either side of the arena, or when their health is reduced to zero.
12757
0e425574bd5f Update README.md: Add game description, controls, getting started guide for n00bs, fix typos, reorganize sections
Wuzzy <Wuzzy2@mail.ru>
parents: 12663
diff changeset
    26
13000
d55aae479f50 Rewrite introduction in README
Wuzzy <Wuzzy2@mail.ru>
parents: 12999
diff changeset
    27
Hedgehogs may move around the terrain in a variety of ways, normally by
d55aae479f50 Rewrite introduction in README
Wuzzy <Wuzzy2@mail.ru>
parents: 12999
diff changeset
    28
walking and jumping but also by using particular tools such as the rope
d55aae479f50 Rewrite introduction in README
Wuzzy <Wuzzy2@mail.ru>
parents: 12999
diff changeset
    29
or parachute, to move to otherwise inaccessible areas. Each **turn is
d55aae479f50 Rewrite introduction in README
Wuzzy <Wuzzy2@mail.ru>
parents: 12999
diff changeset
    30
time-limited** to ensure that players do not hold up the game with
d55aae479f50 Rewrite introduction in README
Wuzzy <Wuzzy2@mail.ru>
parents: 12999
diff changeset
    31
excessive thinking or moving.
12757
0e425574bd5f Update README.md: Add game description, controls, getting started guide for n00bs, fix typos, reorganize sections
Wuzzy <Wuzzy2@mail.ru>
parents: 12663
diff changeset
    32
0e425574bd5f Update README.md: Add game description, controls, getting started guide for n00bs, fix typos, reorganize sections
Wuzzy <Wuzzy2@mail.ru>
parents: 12663
diff changeset
    33
Getting started
0e425574bd5f Update README.md: Add game description, controls, getting started guide for n00bs, fix typos, reorganize sections
Wuzzy <Wuzzy2@mail.ru>
parents: 12663
diff changeset
    34
---------------
13089
e6b0b3e86c2a Update README about the Hedgewars training
Wuzzy <Wuzzy2@mail.ru>
parents: 13012
diff changeset
    35
For complete beginners we recommend to play in singleplayer mode first.
e6b0b3e86c2a Update README about the Hedgewars training
Wuzzy <Wuzzy2@mail.ru>
parents: 13012
diff changeset
    36
Start with the Basic Movement Training found in the training menu.
e6b0b3e86c2a Update README about the Hedgewars training
Wuzzy <Wuzzy2@mail.ru>
parents: 13012
diff changeset
    37
Proceed with the other training missions.
e6b0b3e86c2a Update README about the Hedgewars training
Wuzzy <Wuzzy2@mail.ru>
parents: 13012
diff changeset
    38
After completing the training, try to play some quick matches against the
e6b0b3e86c2a Update README about the Hedgewars training
Wuzzy <Wuzzy2@mail.ru>
parents: 13012
diff changeset
    39
computer (also found in the singleplayer menu).
e6b0b3e86c2a Update README about the Hedgewars training
Wuzzy <Wuzzy2@mail.ru>
parents: 13012
diff changeset
    40
Hedgewars has many weapons, so play a few matches to get a better feeling
e6b0b3e86c2a Update README about the Hedgewars training
Wuzzy <Wuzzy2@mail.ru>
parents: 13012
diff changeset
    41
for them.
12757
0e425574bd5f Update README.md: Add game description, controls, getting started guide for n00bs, fix typos, reorganize sections
Wuzzy <Wuzzy2@mail.ru>
parents: 12663
diff changeset
    42
0e425574bd5f Update README.md: Add game description, controls, getting started guide for n00bs, fix typos, reorganize sections
Wuzzy <Wuzzy2@mail.ru>
parents: 12663
diff changeset
    43
In-depth information about the game can be found online:
0e425574bd5f Update README.md: Add game description, controls, getting started guide for n00bs, fix typos, reorganize sections
Wuzzy <Wuzzy2@mail.ru>
parents: 12663
diff changeset
    44
0e425574bd5f Update README.md: Add game description, controls, getting started guide for n00bs, fix typos, reorganize sections
Wuzzy <Wuzzy2@mail.ru>
parents: 12663
diff changeset
    45
* <https://hedgewars.org/start>: Getting Started
0e425574bd5f Update README.md: Add game description, controls, getting started guide for n00bs, fix typos, reorganize sections
Wuzzy <Wuzzy2@mail.ru>
parents: 12663
diff changeset
    46
* <https://hedgewars.org/wiki.html>: Hedgewars Wiki
0e425574bd5f Update README.md: Add game description, controls, getting started guide for n00bs, fix typos, reorganize sections
Wuzzy <Wuzzy2@mail.ru>
parents: 12663
diff changeset
    47
0e425574bd5f Update README.md: Add game description, controls, getting started guide for n00bs, fix typos, reorganize sections
Wuzzy <Wuzzy2@mail.ru>
parents: 12663
diff changeset
    48
Default controls (excerpt)
0e425574bd5f Update README.md: Add game description, controls, getting started guide for n00bs, fix typos, reorganize sections
Wuzzy <Wuzzy2@mail.ru>
parents: 12663
diff changeset
    49
--------------------------
0e425574bd5f Update README.md: Add game description, controls, getting started guide for n00bs, fix typos, reorganize sections
Wuzzy <Wuzzy2@mail.ru>
parents: 12663
diff changeset
    50
The most important default controls are:
0e425574bd5f Update README.md: Add game description, controls, getting started guide for n00bs, fix typos, reorganize sections
Wuzzy <Wuzzy2@mail.ru>
parents: 12663
diff changeset
    51
0e425574bd5f Update README.md: Add game description, controls, getting started guide for n00bs, fix typos, reorganize sections
Wuzzy <Wuzzy2@mail.ru>
parents: 12663
diff changeset
    52
* Cursor keys: Walk and aim
0e425574bd5f Update README.md: Add game description, controls, getting started guide for n00bs, fix typos, reorganize sections
Wuzzy <Wuzzy2@mail.ru>
parents: 12663
diff changeset
    53
* Mouse: Move camera
0e425574bd5f Update README.md: Add game description, controls, getting started guide for n00bs, fix typos, reorganize sections
Wuzzy <Wuzzy2@mail.ru>
parents: 12663
diff changeset
    54
* Right mouse button: Open ammo menu
0e425574bd5f Update README.md: Add game description, controls, getting started guide for n00bs, fix typos, reorganize sections
Wuzzy <Wuzzy2@mail.ru>
parents: 12663
diff changeset
    55
* Left mouse button: Select target or weapon
0e425574bd5f Update README.md: Add game description, controls, getting started guide for n00bs, fix typos, reorganize sections
Wuzzy <Wuzzy2@mail.ru>
parents: 12663
diff changeset
    56
* Space bar: Shoot
12999
4d4b2fb88e50 Update README about the team chat key
Wuzzy <Wuzzy2@mail.ru>
parents: 12757
diff changeset
    57
* Left shift: Precise (this is a modifier key)
13002
f06660523198 Add separate control for changing hedgehog tags
Wuzzy <Wuzzy2@mail.ru>
parents: 13001
diff changeset
    58
* Precise + Up/Down: Precise aiming
f06660523198 Add separate control for changing hedgehog tags
Wuzzy <Wuzzy2@mail.ru>
parents: 13001
diff changeset
    59
* Precise + Left/Right: Turn around without walking
f06660523198 Add separate control for changing hedgehog tags
Wuzzy <Wuzzy2@mail.ru>
parents: 13001
diff changeset
    60
* Hold down Precise: Prevent slipping on ice
12757
0e425574bd5f Update README.md: Add game description, controls, getting started guide for n00bs, fix typos, reorganize sections
Wuzzy <Wuzzy2@mail.ru>
parents: 12663
diff changeset
    61
* Enter: Jump
0e425574bd5f Update README.md: Add game description, controls, getting started guide for n00bs, fix typos, reorganize sections
Wuzzy <Wuzzy2@mail.ru>
parents: 12663
diff changeset
    62
* Backspace: High jump
0e425574bd5f Update README.md: Add game description, controls, getting started guide for n00bs, fix typos, reorganize sections
Wuzzy <Wuzzy2@mail.ru>
parents: 12663
diff changeset
    63
* Backspace ×2: Backjump
0e425574bd5f Update README.md: Add game description, controls, getting started guide for n00bs, fix typos, reorganize sections
Wuzzy <Wuzzy2@mail.ru>
parents: 12663
diff changeset
    64
* Tab: Switch hedgehog (after activating the utility)
0e425574bd5f Update README.md: Add game description, controls, getting started guide for n00bs, fix typos, reorganize sections
Wuzzy <Wuzzy2@mail.ru>
parents: 12663
diff changeset
    65
* 1-5: Set weapon timer
0e425574bd5f Update README.md: Add game description, controls, getting started guide for n00bs, fix typos, reorganize sections
Wuzzy <Wuzzy2@mail.ru>
parents: 12663
diff changeset
    66
* F1-F10: Weapon shortcuts
13464
08a3851aaf67 Add dedicated key to display mission panel: M
Wuzzy <Wuzzy2@mail.ru>
parents: 13372
diff changeset
    67
* M: Mission panel / game mode information. Hold pressed to display, release to hide
13001
2bafaeed5e2e Rename AFK Mode to “Auto Skip” (bug 78)
Wuzzy <Wuzzy2@mail.ru>
parents: 13000
diff changeset
    68
* P: Pause, when playing offline, toggle automatic turn skipping when online
13464
08a3851aaf67 Add dedicated key to display mission panel: M
Wuzzy <Wuzzy2@mail.ru>
parents: 13372
diff changeset
    69
* Esc: Quit with prompt
12757
0e425574bd5f Update README.md: Add game description, controls, getting started guide for n00bs, fix typos, reorganize sections
Wuzzy <Wuzzy2@mail.ru>
parents: 12663
diff changeset
    70
* T: Chat
13680
d3a4cbba060e Consistently rename "team chat" to "clan chat" (except chat command)
Wuzzy <Wuzzy2@mail.ru>
parents: 13573
diff changeset
    71
* U: Clan chat
12757
0e425574bd5f Update README.md: Add game description, controls, getting started guide for n00bs, fix typos, reorganize sections
Wuzzy <Wuzzy2@mail.ru>
parents: 12663
diff changeset
    72
13524
1232ab8206d4 Add more sane default controls for controller
Wuzzy <Wuzzy2@mail.ru>
parents: 13464
diff changeset
    73
### Default controller controls
1232ab8206d4 Add more sane default controls for controller
Wuzzy <Wuzzy2@mail.ru>
parents: 13464
diff changeset
    74
Hedgewars also supports controllers. By default, Hedgewars sets up a few
1232ab8206d4 Add more sane default controls for controller
Wuzzy <Wuzzy2@mail.ru>
parents: 13464
diff changeset
    75
controls for your first (!) connected controller.
1232ab8206d4 Add more sane default controls for controller
Wuzzy <Wuzzy2@mail.ru>
parents: 13464
diff changeset
    76
This default might not be ideal, we recommend you set manual controls
1232ab8206d4 Add more sane default controls for controller
Wuzzy <Wuzzy2@mail.ru>
parents: 13464
diff changeset
    77
in the settings menu.
1232ab8206d4 Add more sane default controls for controller
Wuzzy <Wuzzy2@mail.ru>
parents: 13464
diff changeset
    78
1232ab8206d4 Add more sane default controls for controller
Wuzzy <Wuzzy2@mail.ru>
parents: 13464
diff changeset
    79
* 1st D-pad: Walk and aim
1232ab8206d4 Add more sane default controls for controller
Wuzzy <Wuzzy2@mail.ru>
parents: 13464
diff changeset
    80
* 2nd D-pad / 1st thumbstick: Move camera/cursor
13538
0c8001e43fd3 Add control to cycle through timer/bounciness values
Wuzzy <Wuzzy2@mail.ru>
parents: 13524
diff changeset
    81
* Button  1: Long jump
0c8001e43fd3 Add control to cycle through timer/bounciness values
Wuzzy <Wuzzy2@mail.ru>
parents: 13524
diff changeset
    82
* Button  2: High jump
0c8001e43fd3 Add control to cycle through timer/bounciness values
Wuzzy <Wuzzy2@mail.ru>
parents: 13524
diff changeset
    83
* Button  3: Attack
0c8001e43fd3 Add control to cycle through timer/bounciness values
Wuzzy <Wuzzy2@mail.ru>
parents: 13524
diff changeset
    84
* Button  4: Ammo menu
0c8001e43fd3 Add control to cycle through timer/bounciness values
Wuzzy <Wuzzy2@mail.ru>
parents: 13524
diff changeset
    85
* Button  5: Precise
0c8001e43fd3 Add control to cycle through timer/bounciness values
Wuzzy <Wuzzy2@mail.ru>
parents: 13524
diff changeset
    86
* Button  6: Select target, or pick weapon (in ammo menu)
0c8001e43fd3 Add control to cycle through timer/bounciness values
Wuzzy <Wuzzy2@mail.ru>
parents: 13524
diff changeset
    87
* Button  7: Switch hedgehog
0c8001e43fd3 Add control to cycle through timer/bounciness values
Wuzzy <Wuzzy2@mail.ru>
parents: 13524
diff changeset
    88
* Button  8: Change timer
0c8001e43fd3 Add control to cycle through timer/bounciness values
Wuzzy <Wuzzy2@mail.ru>
parents: 13524
diff changeset
    89
* Button  9: Find hedgehog / toggle auto camera
0c8001e43fd3 Add control to cycle through timer/bounciness values
Wuzzy <Wuzzy2@mail.ru>
parents: 13524
diff changeset
    90
* Button 10: Mission panel
13524
1232ab8206d4 Add more sane default controls for controller
Wuzzy <Wuzzy2@mail.ru>
parents: 13464
diff changeset
    91
12757
0e425574bd5f Update README.md: Add game description, controls, getting started guide for n00bs, fix typos, reorganize sections
Wuzzy <Wuzzy2@mail.ru>
parents: 12663
diff changeset
    92
For the full list, go to the Hedgewars settings. Also read the weapon tooltips
0e425574bd5f Update README.md: Add game description, controls, getting started guide for n00bs, fix typos, reorganize sections
Wuzzy <Wuzzy2@mail.ru>
parents: 12663
diff changeset
    93
for weapon-specific controls.
0e425574bd5f Update README.md: Add game description, controls, getting started guide for n00bs, fix typos, reorganize sections
Wuzzy <Wuzzy2@mail.ru>
parents: 12663
diff changeset
    94
0e425574bd5f Update README.md: Add game description, controls, getting started guide for n00bs, fix typos, reorganize sections
Wuzzy <Wuzzy2@mail.ru>
parents: 12663
diff changeset
    95
### Special controls
0e425574bd5f Update README.md: Add game description, controls, getting started guide for n00bs, fix typos, reorganize sections
Wuzzy <Wuzzy2@mail.ru>
parents: 12663
diff changeset
    96
0e425574bd5f Update README.md: Add game description, controls, getting started guide for n00bs, fix typos, reorganize sections
Wuzzy <Wuzzy2@mail.ru>
parents: 12663
diff changeset
    97
These are lesser-known controls of Hedgewars, they are based on your
0e425574bd5f Update README.md: Add game description, controls, getting started guide for n00bs, fix typos, reorganize sections
Wuzzy <Wuzzy2@mail.ru>
parents: 12663
diff changeset
    98
configured controls:
0e425574bd5f Update README.md: Add game description, controls, getting started guide for n00bs, fix typos, reorganize sections
Wuzzy <Wuzzy2@mail.ru>
parents: 12663
diff changeset
    99
13012
8a8aaaf97a95 The rottags key alone now toggles hog tags; preecise+rottags is used to cycle tags
Wuzzy <Wuzzy2@mail.ru>
parents: 13006
diff changeset
   100
* Precise + Toggle hedgehog tags: Change visible hedgehog tags (team name/hog name/health)
13538
0c8001e43fd3 Add control to cycle through timer/bounciness values
Wuzzy <Wuzzy2@mail.ru>
parents: 13524
diff changeset
   101
* Switch  + Toggle hedgehog tags: Toggle hedgehog tag translucency
12757
0e425574bd5f Update README.md: Add game description, controls, getting started guide for n00bs, fix typos, reorganize sections
Wuzzy <Wuzzy2@mail.ru>
parents: 12663
diff changeset
   102
* Precise + Toggle team bars + Switch: Toggle HUD
12999
4d4b2fb88e50 Update README about the team chat key
Wuzzy <Wuzzy2@mail.ru>
parents: 12757
diff changeset
   103
* Precise + Capture (screenshot key): Save current map + mask into Screenshot directory
14684
4eaeba349179 Precise+zoom/volume change makes changes in smaller steps
Wuzzy <Wuzzy2@mail.ru>
parents: 14683
diff changeset
   104
* Precise + zoom in/out: Change zoom in smaller steps
4eaeba349179 Precise+zoom/volume change makes changes in smaller steps
Wuzzy <Wuzzy2@mail.ru>
parents: 14683
diff changeset
   105
* Precise + volume up/down: Change volume in smaller steps
14683
c96889bf5796 Precise+resetzoom = 100% zoom (instead of UserZoom)
Wuzzy <Wuzzy2@mail.ru>
parents: 14538
diff changeset
   106
* Precise + Reset zoom: Set zoom to 100% (instead of the zoom level in the settings)
12757
0e425574bd5f Update README.md: Add game description, controls, getting started guide for n00bs, fix typos, reorganize sections
Wuzzy <Wuzzy2@mail.ru>
parents: 12663
diff changeset
   107
13718
20768d813518 Write down system requirements
Wuzzy <Wuzzy2@mail.ru>
parents: 13680
diff changeset
   108
System requirements
20768d813518 Write down system requirements
Wuzzy <Wuzzy2@mail.ru>
parents: 13680
diff changeset
   109
-------------------
20768d813518 Write down system requirements
Wuzzy <Wuzzy2@mail.ru>
parents: 13680
diff changeset
   110
For PC or Mac:
20768d813518 Write down system requirements
Wuzzy <Wuzzy2@mail.ru>
parents: 13680
diff changeset
   111
20768d813518 Write down system requirements
Wuzzy <Wuzzy2@mail.ru>
parents: 13680
diff changeset
   112
* Mouse and keyboard
20768d813518 Write down system requirements
Wuzzy <Wuzzy2@mail.ru>
parents: 13680
diff changeset
   113
* Monitor, minimal resolution 1024×768
20768d813518 Write down system requirements
Wuzzy <Wuzzy2@mail.ru>
parents: 13680
diff changeset
   114
* 200 MiB storage space
20768d813518 Write down system requirements
Wuzzy <Wuzzy2@mail.ru>
parents: 13680
diff changeset
   115
* Processor: 1 GHz (1 core is enough), 64bit recommended
20768d813518 Write down system requirements
Wuzzy <Wuzzy2@mail.ru>
parents: 13680
diff changeset
   116
* Video card: 250 MHz or so
20768d813518 Write down system requirements
Wuzzy <Wuzzy2@mail.ru>
parents: 13680
diff changeset
   117
              (any decent card from the year 2004 or later should do fine)
20768d813518 Write down system requirements
Wuzzy <Wuzzy2@mail.ru>
parents: 13680
diff changeset
   118
* 1 GiB RAM minimum
20768d813518 Write down system requirements
Wuzzy <Wuzzy2@mail.ru>
parents: 13680
diff changeset
   119
* Operating system: Windows Vista/7/8/10, GNU/Linux, macOS, FreeBSD, others
20768d813518 Write down system requirements
Wuzzy <Wuzzy2@mail.ru>
parents: 13680
diff changeset
   120
20768d813518 Write down system requirements
Wuzzy <Wuzzy2@mail.ru>
parents: 13680
diff changeset
   121
Hedgewars has been ported to other operating systems in the past.
20768d813518 Write down system requirements
Wuzzy <Wuzzy2@mail.ru>
parents: 13680
diff changeset
   122
Check out <https://hedgewars.org/download.html> for the latest information.
20768d813518 Write down system requirements
Wuzzy <Wuzzy2@mail.ru>
parents: 13680
diff changeset
   123
20768d813518 Write down system requirements
Wuzzy <Wuzzy2@mail.ru>
parents: 13680
diff changeset
   124
Gamepads are supported partially (only in-game, not in the main menu).
20768d813518 Write down system requirements
Wuzzy <Wuzzy2@mail.ru>
parents: 13680
diff changeset
   125
12757
0e425574bd5f Update README.md: Add game description, controls, getting started guide for n00bs, fix typos, reorganize sections
Wuzzy <Wuzzy2@mail.ru>
parents: 12663
diff changeset
   126
Installation instructions
0e425574bd5f Update README.md: Add game description, controls, getting started guide for n00bs, fix typos, reorganize sections
Wuzzy <Wuzzy2@mail.ru>
parents: 12663
diff changeset
   127
-------------------------
0e425574bd5f Update README.md: Add game description, controls, getting started guide for n00bs, fix typos, reorganize sections
Wuzzy <Wuzzy2@mail.ru>
parents: 12663
diff changeset
   128
See the `INSTALL.md` file.
0e425574bd5f Update README.md: Add game description, controls, getting started guide for n00bs, fix typos, reorganize sections
Wuzzy <Wuzzy2@mail.ru>
parents: 12663
diff changeset
   129
0e425574bd5f Update README.md: Add game description, controls, getting started guide for n00bs, fix typos, reorganize sections
Wuzzy <Wuzzy2@mail.ru>
parents: 12663
diff changeset
   130
Or see our wiki at <https://hedgewars.org/kb/BuildingHedgewars>.
0e425574bd5f Update README.md: Add game description, controls, getting started guide for n00bs, fix typos, reorganize sections
Wuzzy <Wuzzy2@mail.ru>
parents: 12663
diff changeset
   131
0e425574bd5f Update README.md: Add game description, controls, getting started guide for n00bs, fix typos, reorganize sections
Wuzzy <Wuzzy2@mail.ru>
parents: 12663
diff changeset
   132
Source code
0e425574bd5f Update README.md: Add game description, controls, getting started guide for n00bs, fix typos, reorganize sections
Wuzzy <Wuzzy2@mail.ru>
parents: 12663
diff changeset
   133
-----------
0e425574bd5f Update README.md: Add game description, controls, getting started guide for n00bs, fix typos, reorganize sections
Wuzzy <Wuzzy2@mail.ru>
parents: 12663
diff changeset
   134
Our main repository is located at <https://hg.hedgewars.org/hedgewars/> using
0e425574bd5f Update README.md: Add game description, controls, getting started guide for n00bs, fix typos, reorganize sections
Wuzzy <Wuzzy2@mail.ru>
parents: 12663
diff changeset
   135
Mercurial as DVCS. A Git repository is also available (mirrored daily)
0e425574bd5f Update README.md: Add game description, controls, getting started guide for n00bs, fix typos, reorganize sections
Wuzzy <Wuzzy2@mail.ru>
parents: 12663
diff changeset
   136
at <https://github.com/hedgewars/hw>.
11318
78d8255349d3 Add markdown extension to README so github can render it more nicely
Vittorio Giovara <vittorio.giovara@gmail.com>
parents:
diff changeset
   137
12757
0e425574bd5f Update README.md: Add game description, controls, getting started guide for n00bs, fix typos, reorganize sections
Wuzzy <Wuzzy2@mail.ru>
parents: 12663
diff changeset
   138
Contribute
0e425574bd5f Update README.md: Add game description, controls, getting started guide for n00bs, fix typos, reorganize sections
Wuzzy <Wuzzy2@mail.ru>
parents: 12663
diff changeset
   139
----------
11318
78d8255349d3 Add markdown extension to README so github can render it more nicely
Vittorio Giovara <vittorio.giovara@gmail.com>
parents:
diff changeset
   140
If you see a bug or have any suggestion please use the official bug tracker at
12757
0e425574bd5f Update README.md: Add game description, controls, getting started guide for n00bs, fix typos, reorganize sections
Wuzzy <Wuzzy2@mail.ru>
parents: 12663
diff changeset
   141
<https://hedgewars.org/bugs> or the integrated feedback button.
11318
78d8255349d3 Add markdown extension to README so github can render it more nicely
Vittorio Giovara <vittorio.giovara@gmail.com>
parents:
diff changeset
   142
78d8255349d3 Add markdown extension to README so github can render it more nicely
Vittorio Giovara <vittorio.giovara@gmail.com>
parents:
diff changeset
   143
If you want to help or get to know the sources better you can do that with some
12757
0e425574bd5f Update README.md: Add game description, controls, getting started guide for n00bs, fix typos, reorganize sections
Wuzzy <Wuzzy2@mail.ru>
parents: 12663
diff changeset
   144
easy tasks from <https://hedgewars.org/kb/TODO>. We also have an extensive API
0e425574bd5f Update README.md: Add game description, controls, getting started guide for n00bs, fix typos, reorganize sections
Wuzzy <Wuzzy2@mail.ru>
parents: 12663
diff changeset
   145
in Lua to customize your adventures. See our wiki at
0e425574bd5f Update README.md: Add game description, controls, getting started guide for n00bs, fix typos, reorganize sections
Wuzzy <Wuzzy2@mail.ru>
parents: 12663
diff changeset
   146
<https://hedgewars.org/kb/LuaAPI>.
11318
78d8255349d3 Add markdown extension to README so github can render it more nicely
Vittorio Giovara <vittorio.giovara@gmail.com>
parents:
diff changeset
   147
78d8255349d3 Add markdown extension to README so github can render it more nicely
Vittorio Giovara <vittorio.giovara@gmail.com>
parents:
diff changeset
   148
If you know your way through the code feel free to send a patch or open a pull
12757
0e425574bd5f Update README.md: Add game description, controls, getting started guide for n00bs, fix typos, reorganize sections
Wuzzy <Wuzzy2@mail.ru>
parents: 12663
diff changeset
   149
request. The best Lua scripts get released in the official DLC page and later
11318
78d8255349d3 Add markdown extension to README so github can render it more nicely
Vittorio Giovara <vittorio.giovara@gmail.com>
parents:
diff changeset
   150
integrated in the next version.
78d8255349d3 Add markdown extension to README so github can render it more nicely
Vittorio Giovara <vittorio.giovara@gmail.com>
parents:
diff changeset
   151
12757
0e425574bd5f Update README.md: Add game description, controls, getting started guide for n00bs, fix typos, reorganize sections
Wuzzy <Wuzzy2@mail.ru>
parents: 12663
diff changeset
   152
Licence and credits
0e425574bd5f Update README.md: Add game description, controls, getting started guide for n00bs, fix typos, reorganize sections
Wuzzy <Wuzzy2@mail.ru>
parents: 12663
diff changeset
   153
-------------------
0e425574bd5f Update README.md: Add game description, controls, getting started guide for n00bs, fix typos, reorganize sections
Wuzzy <Wuzzy2@mail.ru>
parents: 12663
diff changeset
   154
This game is free software (“free” as in “freedom”). Source code is
0e425574bd5f Update README.md: Add game description, controls, getting started guide for n00bs, fix typos, reorganize sections
Wuzzy <Wuzzy2@mail.ru>
parents: 12663
diff changeset
   155
distributed under the terms of the GNU General Public Licence version 2;
0e425574bd5f Update README.md: Add game description, controls, getting started guide for n00bs, fix typos, reorganize sections
Wuzzy <Wuzzy2@mail.ru>
parents: 12663
diff changeset
   156
images and sounds are distributed under the terms of the GNU Free Documentation
0e425574bd5f Update README.md: Add game description, controls, getting started guide for n00bs, fix typos, reorganize sections
Wuzzy <Wuzzy2@mail.ru>
parents: 12663
diff changeset
   157
Licence version 1.2. See the `COPYING` file for the full text of the licenses.
0e425574bd5f Update README.md: Add game description, controls, getting started guide for n00bs, fix typos, reorganize sections
Wuzzy <Wuzzy2@mail.ru>
parents: 12663
diff changeset
   158
13372
6fd53df98549 Update copyright years
Wuzzy <Wuzzy2@mail.ru>
parents: 13089
diff changeset
   159
Copyright 2004-2018 Andrey Korotaev <unC0Rr@gmail.com> and others.
14451
cb08cecc3bab Update changelog and README
Wuzzy <Wuzzy2@mail.ru>
parents: 13756
diff changeset
   160
Click on the Hedgewars logo in the main menu and read the `CREDITS` text file
cb08cecc3bab Update changelog and README
Wuzzy <Wuzzy2@mail.ru>
parents: 13756
diff changeset
   161
for a more complete list of authors.
12757
0e425574bd5f Update README.md: Add game description, controls, getting started guide for n00bs, fix typos, reorganize sections
Wuzzy <Wuzzy2@mail.ru>
parents: 12663
diff changeset
   162
0e425574bd5f Update README.md: Add game description, controls, getting started guide for n00bs, fix typos, reorganize sections
Wuzzy <Wuzzy2@mail.ru>
parents: 12663
diff changeset
   163
Contact
0e425574bd5f Update README.md: Add game description, controls, getting started guide for n00bs, fix typos, reorganize sections
Wuzzy <Wuzzy2@mail.ru>
parents: 12663
diff changeset
   164
-------
0e425574bd5f Update README.md: Add game description, controls, getting started guide for n00bs, fix typos, reorganize sections
Wuzzy <Wuzzy2@mail.ru>
parents: 12663
diff changeset
   165
* Homepage        - https://hedgewars.org/
11318
78d8255349d3 Add markdown extension to README so github can render it more nicely
Vittorio Giovara <vittorio.giovara@gmail.com>
parents:
diff changeset
   166
* IRC channel     - irc://irc.freenode.net/hedgewars
12757
0e425574bd5f Update README.md: Add game description, controls, getting started guide for n00bs, fix typos, reorganize sections
Wuzzy <Wuzzy2@mail.ru>
parents: 12663
diff changeset
   167
* Community forum - https://hedgewars.org/forum
11318
78d8255349d3 Add markdown extension to README so github can render it more nicely
Vittorio Giovara <vittorio.giovara@gmail.com>
parents:
diff changeset
   168