Online Javadoc

This assignment will be easier to debug (because it moves slower), less graphical, and more about Lists! The fish lives in a grid (2d space) but we mostly only use a List of objects to represent that.

The learning objectives of this assignment are twofold:

1. Learn more Java! Read some bigger starter-code and ask questions!
2. Practice using List<Fish>s! Almost every TODO I left is about a List, although there are some about adding fields to classes.
3. Learn about inheritance -- WorldObject does nearly all the work for Fish, Snail and Rock!

Due Date: February 20, 2020.

Remember that we will have the next assignment opening the next day, so don't save it until the last minute!

Eclipse highlights all the TODO comments that I left throughout the starter code as blue in the scroll-bar. We're going to work through a bunch of them in Lab! And some of them are left for later, when working on this assignment directly.

• When you finish a TODO, delete it!
• TODO(FishGrid) are meant for after lab (once you have a better idea of how the game works).
• In Eclipse, you can see all remaining TODOs by going to "Window > Show View > Tasks"!
• Every solution is just a few lines of code (sometimes even one!) So don't stress out if you spend a lot of time thinking before writing anything (that's intentional).

You must fill out the following Google Form to let me know your accomplishments on this project. I will provide direct feedback to your writing.

When you submit, it tells you can immediately "Edit Your Response" -- copy and paste that link for later if you want to incrementally fill out the Rubric!

This includes that your code should be professional.

• Try to proofread your work like an essay!
• Find all your println("stuff") statements and remove them, etc.
• Your code looks intentional: don't just fiddle with it until it works. Reason about it! Sketch out the python by hand and then try translating to Java.
• Delete commented out code or experiments that don't work out. Make your submission as small as it needs to be.
• Your code is your own. Respect the honor code.
• Working with others or helping them debug is acceptable - use your best judgment! Make sure that you know what you're working on.
• Have comments explaining tricky code!

• You don't need to edit anything but the CONSTANTS in this class for this assignment at all. It's pretty smart already!
• Play the game (WASD or arrow keys). The goal is to collect all the fish. (They just disappear when you get them now).
• Change VISUAL_GRID_SIZE to be bigger so you can see details (but not so big it doesn't fit on your screen!).
• Don't change LOGICAL_GRID_SIZE to be too small! You won't be able to play.

The Fish class for this assignment is familiar, but much simpler! It lives on a grid called the World and doesn't move itself.

• Add fish-colors. The COLORS static array has a list of a few colors. Create more.
• Skip the TODO(FishGrid) for now. We don't know where scoring happens, yet!
• Understand how the color is selected by the drawing code into this array.
• Play the game and see how many more fish appear. (Revisit LOGICAL_GRID_SIZE if too small).

Right now there are only a few rocks, but they're all the same color and are boring. I created an array of colors in the Rock class, but I forgot to hook it up. Let's assign rock colors randomly!

HINT: All 3 TODO comments in this file indicate places you need to add code in order to make it work.

A Fish is-a WorldObject. A lot more functionality is on this class. Every WorldObject knows how to moveUp, moveDown, moveLeft, moveRight, and moveRandomly. They keep track of their recent positions in a special list called a Deque -- or double-ended queue ... there's not a whole lot to it except that it's easy to add and remove from both sides.

There is a lot in the WorldObject class, we will be users of it, rather than editors of it.

FishGame tracks behavior of fish by which list they belong in. We could have had fish swim themselves, kind of like P0 (and have flags for lost, found, and eventually home) but we want to practice using List<Fish> and List<WorldObject> inside of FishGame.

• Wander Missing Fish - The FishGame class has a method called wanderMissingFish. The for loop is almost done, but we want to call one of the Fish movement methods on the fish in the loop. Fix my TODO and play the game again to make sure it works.
• Right now we only generate 5 rocks! - also, public static final int NUM_ROCKS?
• We want a Snail or two - there's a world method to insert a snail randomly; let'ls use it.
• world.remove(wo) - Right now when we find fish we remove them from the world; this doesn't make sense. We want to delete that line and add a line that adds the fish to the list of "found" Fish. We will have to cast our WorldObject to a Fish to do it. We are telling Java we know that it is a Fish, so it is okay to use Fish methods. It will crash later if it was really a Rock and not a Fish.

No TODO for this (the challenge is to know where the edits belong).

The goal here is to make some fish harder to catch than others! Since Fish can only move in whole steps, we can't just adjust the speed, but rather, we need to make the probability they take a step higher for some fish than for others.

Right now, lost fish move 3 out of every 10 turns (because rand.nextDouble chooses a number from 0 to 1). This section proposes making two types of fish that have two different probabilities.

• Lost fish may be fastScared (with some random probability).
• They will move more often randomly if fastScared (p=0.8)?
• Some percentage of Fish just hang out without moving as much (p=0.3).

No TODO for this either (the challenge is to know where the edits belong).

Create a class FallingRock that extends Rock and overrides public void step() { } to move the rock down on every step it can (you can call the WorldObject method moveDown as this.moveDown() because a FallingRock is a Rock and all Rocks are WorldObjects, too!

• (World.java) Answer the questions in World.objectsFollow (Q1..Q5).
• System.out.println statements can help you SEE what the values are.

These are the rest of the TODO(FishGrid); they are a bit harder than the TODO(lab) but you should have a better idea what code does what now.

• (Fish.java, FishGame.java) Have each fish worth some individual number of points (maybe based on color!).
• (FishGame.java) Finish click(x,y) so that a user can click and remove rocks in case we generate a fish trapped in a cave! Be sure that your click ONLY removes Rocks!.
• (World.java) Right now, we only respect Snail space. Fish shouldn't step on each other (unless you're the player, collecting lost Fish) and Fish can't actually swim through rocks! (And vice-versa. Your falling-rocks shouldn't go through your fish.)

There are no TODO comments in the code for challenges. Now you will have to use what you've figured out about how the code works to find edits. Challenge 1 has files that are a hint, the other two challenges involve making new classes.

In this section, beware of deleting from a list while looping over it! addAll and removeAll might be your best friends!

• (FishGame.java) Right now, we win as soon as we find all the Fish. We want to bring them home, too. Whenever your player returns to the home, the fish that are in the found list should move to a new "home" list. Only when that list is full have we "won". You can world.remove(fish) that get home, so they're not all stacked on top of the house.
• (FishGame.java) After 20 or so steps (you can change this) a fish that is too far back in the player's found team (more than 1 fish) has a chance of getting lost again every step (since they can't see you). This will encourage the player to visit the "home" more frequently.
• (FishGame.java) Fish that wander home by accident should be marked accordingly as home!

• At random intervals, hearts will appear somewhere on the board.
• The player will receive points for collecting the hearts.
• The lost fish will collect any hearts they bump into (and the player gets no points).

• Create a Bubble class that extends WorldObject.
• Create a bubble state for Fish. Right now the player sort of has a bubble drawn around them (you can use this drawing code).
• When a Fish bumps into a Bubble, the bubble is removed and the fish enters a "bubble" state.
• A Fish caught in a bubble will be stuck within the bubble and cannot move around.
• A player can click to "pop" the bubble and free the fish.
• A player that bumps into a fish in a bubble will also free them.
• More Difficult (not included): Make bubbles merge with each other & pop when they hit rocks.
• More Difficult (not included): Player can get trapped in Bubble and must click to escape: requires modifying code in Main.java.