From 204025662d47aa3daf948c3b1bc53b3515b958ee Mon Sep 17 00:00:00 2001 From: Leonardo Brandenberger Date: Fri, 10 Dec 2021 19:37:37 +0100 Subject: [PATCH 1/3] Improved Readme a little, more room for improvement still. --- README.md | 81 ++++++++++++++++++++++++++++--------------------------- 1 file changed, 42 insertions(+), 39 deletions(-) diff --git a/README.md b/README.md index 0c6a45a..f98574f 100644 --- a/README.md +++ b/README.md @@ -1,53 +1,58 @@ # Siedler of Catan -Siedler of Catan is a multi-player-roleplay game, that lets you build roads, -settlements and cites in the world of region of catan. You have to try to build -as many roads, settlements and cities as you can to get points. It is also a -strategic game where you have to choose wisely where to build your structures, -to be able to dominate your friends. +Siedler of Catan is a multi-player-roleplay game, that lets you create settlements, +build roads and upgrade settlements to cites in the world of catan. +You have to try to get the required amount of winpoints as fast as possible to come out as the winner. +You collect winpoints by owning settlements and cities and even get an extra two for owning the longest road. +It is also a strategic game, so you will have to choose wisely where to place your Structures. #Rules 1. The minimum Player amount is 2 and the maximum Player amount is 4. 2. The minimum amount if win points is 3. 3. Each Player can build two roads and two settlements free of cost at the beginning of -the game. After the placement, each player gets resources from the field around the second settlement. -4. Every Player is being sorted into a faction. There cannot be two players in the +the game. After placing the second settlement the players will each receive the resources from around the second settlement. +4. Every Player receives a faction. There cannot be two players in the same faction. 5. A player cannot build two settlements or cities right next one another. There have to be at least two roads between them. 6. The cost for each structure is set and is nonnegotiable. -7. The player with the longest road (most roads connecting to one another), which is longer then 4 -will be awarded two additional points. -8. If a player rolls a 7 on a dice throw, then the resources of every player that has -more than 7 resources will be halved. The resources that are being taken are chosen +7. The player with the longest road (most roads connecting to one another), which is longer than 4 +will be awarded two additional winpoints. +8. If a player rolls a 7 on a dice throw, all player that are holding more than 7 resources, +will lose half of all their resources. The resources that are being taken are chosen by random. For a more detailed version of the rules please look here: https://www.catan.de/sites/prod/files/2021-06/CATAN_DasSpiel_Spielregel.pdf #Usermanual -First the program will ask how many players will be playing the game. The minimum -amount of players is 2 and the maximum amount of players is 4. Each player will -be appointed to a faction. In the next step, the program ask for the number of win points. The first player who reaches this number of win points, will win the game. Now every player can build a settlement and a road -after every player has built a settlement and road, they can build a second -settlement and road in reversed order. When the players build their second -settlement they then receive the resources surrounding that specific settlement. -Now that the setup is complete the next player can start with the first dice throw. After the players have rolled the dice the fields connected to the -number that the player rolled with the dice will pay the associated resources to the players who have placed a settlement on a corner around of the field. -If the settlement is upgraded to a city, the player gets two of the appropriate resource. +Setup Phase: +1. Enter the number of players that will be playing. (min 2, max 4) +2. Enter the number of winpoints needed to win the game. (min 3) +3. Each player is given a faction it is your as soon as the console says it is your faction's turn. +4. Every Faction will receive the possibility to place a settlement with a corresponding road. (no resource cost) +5. Play order is reversed and every faction receives a second settlement and a road to place. (no resource cost) +Each faction will afterwards receive the resources surrounding the second settlement. -To execute a action type in the associated number of the command, which is showed in the terminal. +After the setup phase the game phase will begin and continue until a winner emerges or the game gets quit via the quit command. -#1. Next Player -``next player`` Ends a players turn +Navigate in the Game Phase: + +>It is your turn as soon as the console shows it is your turn. + +>To execute an action type in the associated number of the command, which is showed in the terminal. +Same applies when asked about resources. + + +#Avaible Commands: +>``next player`` Ends a players turn and the next player turn will be started When the current player has done all the building and trading they wanted and now -want to end their turn they can end it by entering the command next player. By entering -this command the player relinquishes their turn and the next player may start their -turn. +want to end their turn they can end it by entering the command next player. By choosing +the command the player finishes their turn and the next player is at turn -#2. Build Settlement -``build settlement`` Builds a settlement + +>``build settlement`` Builds a settlement at the chosen location. When it's the players turn, they can build a new settlement by giving the command build settlement. With that they will be asked where they want to build said settlement @@ -56,8 +61,8 @@ program will subtract the resources needed to build a settlement. If the player insufficient resources the settlement will not be built and an error message will appear. The turn of the current player will continue until the player ends it. -#3. Build City -``build city`` Builds a city + +>``build city`` Builds a city at the chosen location. During the players turn they can build a city on the same coordinates that they have already built a settlement on. To do that they have to enter the command @@ -68,11 +73,11 @@ will then check if the player has sufficient resources to build the city, then the program will subtract them of the players resources, otherwise the city won't be build and the player continues their turn until they end it. -#4. Build Road -``build road`` Builds a road -During the current players turn, the player can build a new road by giving the -command build road. Then the player will be asked to give the coordinates of the start corner and the end corner for where +>``build road`` Builds a road at chosen location. + +During the current players turn, the player can build a new road by choosing the +command build road. The player will be asked to give the coordinates of the start corner and the end corner for where they want to build the new road after entering the coordinates the program will check to see if they are valid coordinates and if they aren't occupied. If the coordinates are checked and there was no error message, then the program @@ -81,8 +86,7 @@ program will then subtract the amount of resources of the player. If they do not have enough resources the road will not be built and the player will receive an error message. The player continues their turn until they end it. -#5. Trade with Bank -``trade with bank`` Let's the player trade resources with the bank +>``trade with bank`` Starts the trade with the bank The current player can trade resources with the bank by entering the command trade with bank. The player then can enter what and how many resources they want @@ -92,10 +96,9 @@ trade for one of their choosing from the bank. If they do not have enough resour to give the trade will not be completed and the player may continue their turn. -#6. Quit -``quit`` Let's a player quit the game +>``quit`` Quits the game completely. -If a player wants to quit the game they can enter the command quit while it's their +If a player wants to quit the game they can choose the command quit while it's their turn to quit the game. #Coordinates From 3740cc175e2bf3f1df105911533921548589da9f Mon Sep 17 00:00:00 2001 From: Leonardo Brandenberger Date: Fri, 10 Dec 2021 20:25:04 +0100 Subject: [PATCH 2/3] Improved Readme a little, more room for improvement still. --- .idea/git_toolbox_prj.xml | 15 +++++++++++++++ .idea/runConfigurations.xml | 10 ++++++++++ 2 files changed, 25 insertions(+) create mode 100644 .idea/git_toolbox_prj.xml create mode 100644 .idea/runConfigurations.xml diff --git a/.idea/git_toolbox_prj.xml b/.idea/git_toolbox_prj.xml new file mode 100644 index 0000000..b382006 --- /dev/null +++ b/.idea/git_toolbox_prj.xml @@ -0,0 +1,15 @@ + + + + + + + \ No newline at end of file diff --git a/.idea/runConfigurations.xml b/.idea/runConfigurations.xml new file mode 100644 index 0000000..797acea --- /dev/null +++ b/.idea/runConfigurations.xml @@ -0,0 +1,10 @@ + + + + + + \ No newline at end of file From c8cbd1cacc8d8d67dbf003ad579ed22cc9e05c0d Mon Sep 17 00:00:00 2001 From: Leonardo Brandenberger Date: Fri, 10 Dec 2021 21:35:42 +0100 Subject: [PATCH 3/3] Improved Readme --- README.md | 75 ++++++++++++++++++++++++------------------------------- 1 file changed, 33 insertions(+), 42 deletions(-) diff --git a/README.md b/README.md index f98574f..421d6d8 100644 --- a/README.md +++ b/README.md @@ -1,5 +1,5 @@ # Siedler of Catan -Siedler of Catan is a multi-player-roleplay game, that lets you create settlements, +Siedler of catan is a multi-player-roleplay game, that lets you create settlements, build roads and upgrade settlements to cites in the world of catan. You have to try to get the required amount of winpoints as fast as possible to come out as the winner. You collect winpoints by owning settlements and cities and even get an extra two for owning the longest road. @@ -18,12 +18,13 @@ There have to be at least two roads between them. 7. The player with the longest road (most roads connecting to one another), which is longer than 4 will be awarded two additional winpoints. 8. If a player rolls a 7 on a dice throw, all player that are holding more than 7 resources, -will lose half of all their resources. The resources that are being taken are chosen -by random. +will lose half of all their resources. The resources that are being taken are chosen randomly. +9. Winpoints get awarded as following: (Settlement: 1), (City: 2), (Longest Road: 2) + For a more detailed version of the rules please look here: https://www.catan.de/sites/prod/files/2021-06/CATAN_DasSpiel_Spielregel.pdf -#Usermanual +#How To Play Setup Phase: 1. Enter the number of players that will be playing. (min 2, max 4) 2. Enter the number of winpoints needed to win the game. (min 3) @@ -38,62 +39,52 @@ Navigate in the Game Phase: >It is your turn as soon as the console shows it is your turn. ->To execute an action type in the associated number of the command, which is showed in the terminal. +>To execute an action type in the associated number of the command which is showed in the terminal. Same applies when asked about resources. +> Note that the dice throwing gets done automatically before each turn, +and you get informed in the console which number has been chosen. +The resources will also be added to the corresponding factions automatically. + +>You can do as many Commands as you like per turn. If decide to finish your turn, you can do so using the next player command. + #Avaible Commands: ->``next player`` Ends a players turn and the next player turn will be started - -When the current player has done all the building and trading they wanted and now -want to end their turn they can end it by entering the command next player. By choosing -the command the player finishes their turn and the next player is at turn - - +>``next player`` Ends a players turn and the next player turn will be started >``build settlement`` Builds a settlement at the chosen location. -When it's the players turn, they can build a new settlement by giving the command -build settlement. With that they will be asked where they want to build said settlement -and to enter the coordinates, then the program will check if those coordinates are available or not. Then the -program will subtract the resources needed to build a settlement. If the player has -insufficient resources the settlement will not be built and an error message will -appear. The turn of the current player will continue until the player ends it. +You will be prompted to give coordinates for the settlement. If the coordinates are valid +and comply with all siedler rules a settlement of your faction will be build on the map. +If the coordinates aren't a valid position you will be prompted to input them again. +If there is an illegal move for example not enough resources or invalid field an error will be shown. + >``build city`` Builds a city at the chosen location. -During the players turn they can build a city on the same coordinates that they -have already built a settlement on. To do that they have to enter the command -build city. Then they have to add the coordinates that they want the city to be -built at. If the coordinates are available and the settlement at that coordinate is -of the same faction as the player then the city can be built there. The program -will then check if the player has sufficient resources to build the city, then -the program will subtract them of the players resources, otherwise the city won't -be build and the player continues their turn until they end it. - +You will be prompted to give the coordinates for an existing settlement. If the coordinates are valid +and comply with all siedler rules a city of your faction will be build on the map. +If the coordinates aren't a valid position you will be prompted to input them again. +If there is an illegal move for example not enough resources or invalid field an error will be shown. >``build road`` Builds a road at chosen location. -During the current players turn, the player can build a new road by choosing the -command build road. The player will be asked to give the coordinates of the start corner and the end corner for where -they want to build the new road after entering the coordinates the program will -check to see if they are valid coordinates and if they aren't occupied. -If the coordinates are checked and there was no error message, then the program -will check if the player has enough resources to build the road if they do the -program will then subtract the amount of resources of the player. If they do not -have enough resources the road will not be built and the player will receive -an error message. The player continues their turn until they end it. +You will be prompted to give two coordinate sets, the first coordinate of the start of the road and the second one +of the end of the road.If the coordinates aren't a valid position you will be prompted to input them again. +If there is an illegal move for example not enough resources or invalid field an error will be shown. + + >``trade with bank`` Starts the trade with the bank -The current player can trade resources with the bank by entering the command -trade with bank. The player then can enter what and how many resources they want -then they have to enter what resources they will give in return. The trade course -for the resources is set to 1:4. That means the player will have to give 4 resources -trade for one of their choosing from the bank. If they do not have enough resources -to give the trade will not be completed and the player may continue their turn. +You will first be prompted to input the resource that you offer. +Afterwards you will be prompted to input the resource that you would like to receive. +The Trade is in a 4 to 1 ratio, meaning that you give 4 resources to receive 1. +If you own the needed resources the trade will be completed. +If the bank doesn't have your desired resource, or you don't own enough resources of the one to give, +an error message will be shown. >``quit`` Quits the game completely.